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为 本 科 院 校 , 大 专 院 校 . 手 机 应 用 软件 培训 机 构 的 相关 课程 教材 ,而 且 也 可 以 作为 无 线 互联 网 应 用 开发 设计 
人 员 的 参考 用 书 。 
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随 着 我 国 改革 开放 的 进一步 深化 ,高 等 教育 也 得 到 了 快速 发 展 , 各 地 高 校 紧密 结合 地 方 经 
济 建设 发 展 需要 ,科学 运用 市 场 调节 机 制 ,加 大 了 使 用 信息 科学 等 现代 科学 技术 提升 ,改造 传 
统 学 科 专 业 的 投入 力度 ,通过 教育 改革 合理 调整 和 配置 了 教育 资源 ,优化 了 传统 学 科 专 业 , 积 
极为 地 方 经 济 建设 输送 人 才 ,为 我 国 经 济 社会 的 快速 、 健 康 和 可 持续 发 展 以 及 高 等 教育 自身 的 
改革 发 展 做 出 了 巨大 贡献 。 但 是 ,高 等 教育 质量 还 需要 进一步 提高 以 适应 经 济 社会 发 展 的 需 
要 ,不 少 高 校 的 专业 设置 和 结构 不 尽 合理 ,教师 队伍 整体 素质 亚 待 提高 ,人 才 培 养 模式 .教学 内 
容 和 方法 需要 进一步 转变 ,学 生 的 实践 能 力 和 创新 精神 亚 待 加 强 。 

教育 部 一 直 十 分 重视 高 等 教育 质量 工作 。2007 年 1 月 ,教育 部 下 发 了 《关于 实施 高 等 学 
校本 科教 学 质量 与 教学 改革 工程 的 意见 》, 计 划 实 施 “ 高 等 学 校本 科教 学 质量 与 教学 改革 工程 ” 
(简称 “质量 工程 ”) ,通过 专业 结构 调整 .课程 教材 建设 实践 教学 改革 ,教学 团队 建设 等 多 项 内 
容 , 进 一 步 深化 高 等 学 校 教学 改革 ,提高 人 才 培 养 的 能 力 和 水 平 , 更 好 地 满足 经 济 社会 发 展 对 
高 素质 人 才 的 需要 。 在 贯彻 和 落实 教育 部 “质量 工程 ”的 过 程 中 ,各 地 高 校 发 挥 师资 力量 强 ,办 
学 经 验 丰 富 ,教学 资源 充裕 等 优势 ,对 其 特色 专业 及 特色 课程 ( 群 ) 加 以 规划 、 整 理 和 总 结 , 更 新 
教学 内 容 ,改革 课程 体系 ,建设 了 一 大 批 内 容 新 ,体系 新 方法 新 、 手 段 新 的 特色 课程 。 在 此 基 
础 上 ,经 教育 部 相关 教学 指导 委员 会 专家 的 指导 和 建议 ,清华 大 学 出 版 社 在 多 个 领域 精 选 各 高 
校 的 特色 课程 ,分 别 规划 出 版 系列 教材 ,以 配合 “质量 工程 ”的 实施 ,满足 各 高 校 教学 质量 和 教 
学 改革 的 需要 。 

为 了 深入 贯彻 落实 教育 部 (关于 加 强 高 等 学 校本 科教 学 工作 ,提高 教学 质量 的 若干 意见 》 
精神 ,紧密 配合 教育 部 已 经 启动 的 “高 等 学 校 教学 质量 与 教学 改革 工程 精品 课程 建设 工作 ”, 在 
有 关 专 家 教授 的 倡议 和 有 关 部 门 的 大 力 支 持 下 ,我 们 组 织 并 成 立 了 “清华 大 学 出 版 社 教材 编 
审 委员 会 (以 下 简称 “ 编 委 会 ”) , 旨 在 配合 教育 部 制定 精品 课程 教材 的 出 版 规划 ,讨论 并 实施 
精品 课程 教材 的 编写 与 出 版 工作 。“ 编 委 会 ?成员 皆 来 自 全国 各 类 高 等 学 校 教学 与 科研 第 一 线 
的 骨干 教师 ,其 中 许多 教师 为 各 校 相关 院 、 系 主管 教学 的 院 长 或 系 主任 。 

按照 教育 部 的 要 求 ,“ 编 委 会 ”一 致 认为 ,精品 课程 的 建设 工作 从 开始 就 要 坚持 高 标准 、 严 
要 求 ,处 于 一 个 比较 高 的 起 点 上 。 精 品 课程 教材 应 该 能 够 反映 各 高 校 教学 改革 与 课程 建设 的 
需要 ,要 有 特色 风格 有 创新 性 (新 体系 、 新 内 容 、 新 手段 .新 思路 ,教材 的 内 容 体 系 有 和 较 高 的 科 
学 创新 ,技术 创新 和 理念 创新 的 含量 ) .先进 性 (对 原 有 的 学 科 体系 有 实质 性 的 改革 和 发 展 , 顺 
应 并 符合 21 世纪 教学 发 展 的 规律 ,代表 并 引领 课程 发 展 的 趋势 和 方向 ) .示范 性 (教材 所 体现 
的 课程 体系 具有 和 较 广泛 的 辐射 性 和 示范 性 ) 和 一 定 的 前 瞻 性 。 教 材 由 个 人 申报 或 各 校 推 荐 ( 通 
过 所 在 高 校 的 “ 编 委 会 "成 员 推 荐 ) ,经 “ 编 委 会 认真 评审 ,最 后 由 清华 大 学 出 版 社 审定 出 版 。 

目前 ,针对 计算 机 类 和 电子 信息 类 相关 专业 成 立 了 两 个 “ 编 委 会 ”, 即 “清华 大 学 出 版 社 计 
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算 机 教材 编审 委员 会 ”> 和 ”清华 大 学 出 版 社 电 子 信息 教材 编审 委员 会 >。 推出 的 特色 精品 教材 
包括 : 


(D 21 世纪 高 等 学 校规 划 教材 


业 的 计算 机 应 用 类 教材 。 
(2) 21 世纪 高 等 学 校规 划 教材 。 计算 机 科学 与 技术 一 一 高 等 学 校 计算 机 相关 专业 的 


教材 。 
G) 21 世纪 高 等 学 校规 划 教 材 。 
(4) 21 世纪 高 等 学 校规 划 教材 。 
(5) 21 世纪 高 等 学 校规 划 教材 。 
(6) 21 世纪 高 等 学 校规 划 教材 。 
(7) 21 世纪 高 等 学 校规 划 教材 。 
(8) 21 世纪 高 等 学 校规 划 教材 。 


计算 机 应 用 一 一 高 等 学 校 各 类 专业 ,特别 是 非 计算 机 专 


电子 信息 一 一 高 等 学 校 电 子 信息 相关 专业 的 教材 。 
软件 工程 一 一 高 等 学 校 软件 工程 相关 专业 的 教材 。 
信息 管理 与 信息 系统 。 

财经 管理 与 应 用 。 

电子 商务 。 

物 联网 。 


清华 大 学 出 版 社 经 过 三 十 多 年 的 努力 ,在 教材 尤其 是 计算 机 和 电子 信息 类 专业 教材 出 版 
方面 树立 了 权威 品牌 ,为 我 国 的 高 等 教育 事业 做 出 了 重要 贡献 。 清 华 版 教材 形成 了 技术 准确 、 
内 容 严谨 的 独特 风格 ,这 种 风格 将 延续 并 反映 在 特色 精品 教材 的 建设 中 。 


清华 大 学 出 版 社 教材 编审 委员 会 
联系 人 : 魏 江 江 


E-mail: weijj(? tup. tsinghua. edu. cn 


Android 是 一 个 优秀 的 开源 手机 平台 。 本 书 以 Android 2. 3. 3 为 系统 平台 ,使 用 Eclipse 
为 开发 工具 ,介绍 在 Android 平台 上 进行 应 用 开发 的 知识 和 技术 。 本 书 吸收 了 Android 开发 
设计 类 书籍 的 优点 ,总 结 了 一 些 培训 机 构 的 教学 经 验 , 从 教学 的 角度 全 面 介绍 了 Android 应 用 
程序 的 开发 设计 ,深浅 适宜 ,实例 丰富 ,不 仅 可 作为 本 科 院 校 , 大 专 院 校 高 职高 专 和 计算 机 培 
训 机 构 的 相关 课程 的 教材 ,而 且 也 可 作为 Android 系统 开发 设计 人 员 的 开发 参考 书 。 

EPH 12 章 ,内 容 分 为 以 下 4 部 分 。 

第 1 部 分 是 Android 概述 及 基本 概念 ,由 第 1,2 章 描 述 ,介绍 Android 开发 起 步 ,Android 
应 用 程序 的 构成 。 

第 2 部 分 是 开发 入门 ,由 第 3 一 6 章 描 述 ,介绍 Android 应 用 程序 的 控制 机 制 ,常用 基本 控 
件 ,高 级 控件 及 事件 处 理应 用 ,菜单 与 对 话 框 等 内 容 。 

第 3 部 分 是 开发 进 阶 ,由 第 7 一 11 章 描述 ,介绍 Android 的 数据 存储 ,多 媒体 应 用 开发 ,后 
台 处 理 , 网 络 与 位 置地 图 ,手机 基本 功能 开发 等 内 容 。 

第 4 部 分 是 综合 应 用 实例 开发 ,由 第 12 章 描 述 ,介绍 应 用 项 目 实例 的 开发 设计 。 

Android 课程 内 容 十 分 丰富 ,实践 性 强 , 教 学 课时 建议 不 低 于 90 学 时 ,并 且 需 要 保证 充足 
的 实践 课时 数 , 建 议 实践 课 课 时 不 低 于 48 学 时 。 

本 书 凝聚 了 作者 多 年 的 教学 与 手机 开发 经 验 , 讲 解 深入 透彻 ,论述 通俗 易 懂 , 注 重 知识 的 
系统 性 ,案例 解析 清晰 透彻 。 凡 具备 编程 基础 的 人 员 都 可 以 通过 本 书 的 学 习 掌 握 Android 的 
应 用 编程 。 

本 书 的 主要 章节 由 张 冬 玲 编写 。 杨 宁 完 成 第 12 章 , 包 括 应 用 实例 的 系统 功能 设计 ,服务 
器 端 .手机 客户 端 应 用 项 目的 编程 ,以 及 通信 协议 的 编写 等 内 容 。 刘 雄 负责 本 教程 的 部 分 案例 
的 设计 。 芦 晓 拓 完成 各 章 的 练习 题 编写 。 全 书 由 张 冬 玲 统 稿 与 定稿 。 

由 于 作者 水 平 有 限 , 书 中 难免 会 有 朴 漏 与 不 足 之 处 , 敬 请 各 位 专家 与 读者 指正 。 


编者 GA 
于 中 山大 学 新 华 学 院 (广州 ) 
2012 年 8 月 26 日 
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B Android 移动 开发 平台 概述 


1.1.1 认识 Android 


Android 系统 是 由 Google 公司 推出 的 手机 操作 系统 。 它 的 标志 是 一 个 名 叫 Android 的 
小 机 器 人 , 它 来 源 于 法 国 作家 利 尔 。 亚 当 在 1886 年 发 表 的 科幻 小 说 (未 来 夏娃 ) 中 ,作者 为 小 
说 里 的 机 器 人 起 名 为 Android。 最 开始 的 时 候 , 研 发 Android 系统 是 由 一 个 名 为 Android 的 
公司 进行 的 ,2005 年 Google 公司 收购 了 这 个 仅 成 立 22 个 月 的 高 科技 企业 ,由 Google 公司 接 
手 研 发 Android 系统 ,Android 系统 的 创始 人 ,Android 公司 的 CEO 安 迪 。 重 宾 , 成 为 Google 
公司 的 工程 部 副 总 裁 , 继 续 负 责 Android 项 目的 研发 工作 。 

2007 年 11 月 5 日 ,Google 公 司 正 式 向 外 界 展 示 了 Android 的 操作 系统 ,并 且 宣布 将 建立 
一 个 全 球 性 的 联盟 组 织 , 该 组 织 由 摩托 罗拉 、 索 尼 爱 立信 Sony Ericsson .韩国 三 星 电 子 、 韩 国 
LG 电子 ,台湾 宏 达 国 际 电子 HTC, P Ed f£ zl] China Mobile、 意 法 半导体 ST、 英 特 尔 Intel, 
Skype(eBay) 等 34 家 手机 制造 商 , 软 件 开发 商 \ 电 信和 运营 商 以 及 芯片 制造 商 共 同 组 成 。 这 一 
联盟 将 支持 Google 发 布 的 手机 操作 系统 以 及 应 用 软件 ,将 共同 开发 Android 系统 的 开放 源 代 
码 。2008 4E 9 月 ,Google 正式 发 布 了 Android 1. 0 系统 ,这 也 是 Android 系统 最 早 的 版 本 。 
从 此 ,Google 开启 了 一 个 新 的 手机 系统 辉煌 时 代 。 

目前 手机 市 场 上 , 随 着 Android 平台 的 发 展 以 及 不 断 完 善 , 越 来 越 多 的 手机 厂商 开始 选择 
Android 系统 作为 其 主要 发 展 方向 ,Android 系统 在 全 球 手 机 市 场 上 已 经 占据 市 场 份额 第 一 
的 位 置 许久 。 虽 然 随 着 近期 WP7 的 推出 ,手机 智能 系统 的 竞争 愈加 激烈 。 但 就 目前 来 说 ， 
Android 手机 的 统治 地 位 还 是 无 法 改变 的 。 


1.1.2 Android 的 发 展 历史 


2007 年 11 月 ,Google 公司 宣布 其 基于 Linux 平台 的 开源 手机 操作 系统 的 项 目 代 号 为 
* Android" , 

2008 年 3 H . Android SDK 发 布 , 代 号 为 m5-rc15; 同年 8 H . Android 0. 9 SDK beta 版 
本 发 布 ,代号 为 m5-0. 9; 同年 9 月 23 日 ,美国 运营 商 T-Mobile 在 纽约 正式 发 布 第 一 款 
Android 手机 T-Mobile G1, 它 成 为 Android 1. 0 代表 机 型 。 该 款 手 机 由 台湾 宏达电 子 (HTC) 
代 工 制造 ,是 世界 上 第 一 部 使 用 Android 操作 系统 的 手机 ,支持 WCDMA 网 络 ,并 支持 
WiFi; 当天 ,Android 1.0 SDK 发 布 。 


2 


Nf 


Android 应 用 开发 教程 


2009 年 2 月 ,Android 1. 1 SDK 发 布 ; 同年 5 月 ,Android 1. 5 SDK 发 布 ,其 代表 机 型 为 
HTC G2,G1 和 G2 逐渐 被 市 场 接受 。 从 Android 1. 5 版 本 开始 ,Google 开始 将 Android 的 版 
本 以 甜品 的 名 字 命名 ,Android 1.5 命名 为 Cupcake( 纸 杯 蛋糕 ) 。 该 系统 与 Android 1. 0 相 比 
有 了 很 大 的 改进 。 如 : 摄 /播放 影片 ,并 支持 上 传 到 Youtube; 最 新 的 采用 WebKit 技术 的 浏 
览 器 ,支持 复制 /粘贴 和 页 面 中 搜索 ; 提供 屏幕 虚拟 键盘 ; 应 用 程序 自动 随 着 手机 旋转 ; 短信 、 
Gmail, 日历, 浏览 器 的 用 户 接口 大 幅 改进 ,如 Gmail 可 以 批量 删除 邮件 ; 来 电 照片 显示 等 。 

2009 4 9 H , Android 1. 6 SDK 发 布 ,其 代表 机 型 为 HTC Hero G3, HTC Hero G3 成 为 
最 受 欢 迎 的 机 型 。Google 为 Android 1.6 命名 为 代号 为 Donut( 甜 甜 圈 )。Android 1. 6 改进 
如 下 : 重新 设计 的 Android Market 手势 ,支持 CDMA 网 络 ,文字 转 语音 系统 (Text-to- 
Speech) ,快速 搜索 框 ,全 新 的 拍照 接口 ,查看 应 用 程序 耗 电 ,支持 虚拟 私人 网 络 (VPN) ,支持 更 
多 的 屏幕 分 辨 率 ,支持 OpenCore 2 媒体 引擎 ,新 增 面 向 视觉 或 听觉 困难 人 群 的 易 用 性 插件 等 。 

2009 年 10 月 ,发 布 了 Android 2. 0 操作 系统 ,2010 年 1 月 ,发 布 Android 2.1, 并 推出 
Google 旗下 第 一 款 自主 品牌 手机 Nexus One, 该 机 成 为 Android 2. 1 的 代表 机 型 ,由 HTC 代 
工 生 产 。 此 时 ,众多 厂商 加 盟 支持 ,机 型 越 来 越 多 ,市 场 反应 和 占有 率 越 来 越 高 。Google 将 
Android 2. 0 至 Android 2. 1 系统 的 版 本 统称 为 Eclair( 松 饼 ) ,新 系统 与 日 系统 相 比 进行 了 较 
大 的 改进 。Android 2. 0—2. 1 改进 如 下 : 优化 硬件 速度 ,改良 的 用 户 界面 ,新 的 浏览 器 的 用 户 
接口 和 支持 HTML5 ,改进 Google Maps 3.1.2, 支 持 内 置 相机 闪光 灯 ,支持 数码 变焦 ,改进 的 
虚拟 键盘 ,支持 蓝牙 2. 1, 支 持 动 态 桌 面 的 设计 等 。 

2010 年 5 月 ,Android 2.2 SDK 发 布 ,其 代表 机 型 为 DHD 和 GALAXY S。Google 为 其 
命名 为 Froyo( 冻 酸奶 )。Android 2. 2 操作 系统 在 当时 受到 了 广泛 的 关注 ,根据 美国 NDP 集 
团 调查 显示 ,在 当时 Android 系统 已 占据 了 美国 移动 系统 市 场 28% 的 份额 ,在 全 球 占 据 了 
17% 的 市 场 份 额 。 到 2010 年 9 月 ,Android 系统 的 应 用 数量 已 经 超过 了 9 万 个 ,Google 公布 
每 日 销售 的 Android 系统 设备 的 新 用 户 数量 达到 20 万 ,Android 系统 取得 了 巨大 的 成 功 。 
Android 2.2 改进 如 下 : 整体 性 能 大 幅度 的 提升 ,3G 网 络 共享 功能 ,支持 Flash, App2sd 功能 ， 
全 新 的 软件 商店 ,更 多 的 Web 应 用 API 的 开发 。 

2010 年 10 月 ,Google 宣布 Android 系统 达到 了 第 一 个 里 程 碑 , 即 电子 市 场 上 获得 官方 数 
字 认 证 的 Android 应 用 数量 已 经 达到 了 10 万 个 ,Android 系统 的 应 用 增长 非常 迅速 。2010 年 
12 月 ,Google 正式 发 布 了 Android 2. 3 操作 系统 Gingerbread (HWH) ,其 代表 机 型 是 三 星 的 
GALAXYSII fl HTC Sensation, Android 2. 3 改进 如 下 : 增加 了 新 的 垃圾 回收 和 优化 处 理 
事件 ,原生 代码 可 直接 存 取 输入 和 感应 器 事件 ,EGL/OpenGL ES,OpenSL ES, 新 的 管理 窗口 
和 生命 周期 的 框架 ,支持 VP8 和 WebM 视频 格式 ,提供 AAC 和 AMR 宽频 编码 ,提供 了 新 的 
音频 效果 器 ,支持 前 置 摄像 头 .SIP/VOIP 和 NFC( 近 场 通信 ) ,简化 界面 ,速度 提升 ,一 键 文字 
选择 和 复制 /粘贴 ,改进 的 电源 管理 系统 ,新 的 应 用 管理 方式 等 。 

2011 年 1 月 ,第 一 款 采 用 Android 3 平台 的 平板 计算 机 问世 。 同 年 2 月 ,Android 3 SDK 发 
布 。Android 3. 0 是 专门 针对 平板 计算 机 进行 优化 的 操作 系统 。Android 进入 平板 计算 机 时 代 。 

2011 年 7 月 ,Google 称 每 日 的 Android 设备 新 用 户 数量 达到 了 55 万 部 ,而 Android 系统 
设备 的 用 户 总 数 达 到 了 1. 35 亿 ,Android 系统 已 经 成 为 智能 手机 领域 占有 量 最 高 的 系统 。 
2011 年 9 月 ,Google 发 布 了 全 新 的 Android 4. 0 操作 系统 ,Android 4. 0 的 代表 机 型 就 是 
NEXUS Prime 和 Droid Razr。 这 款 系统 被 命名 为 Ice Cream Sandwich( 冰 激 凌 三 明治 )。 这 
款 全 新 的 Android 系统 结合 了 Android 2. 3 与 Android 3. 0 的 优点 ,支持 手机 设备 与 平板 设 
备 。Android 4. 0 系统 拥有 全 新 的 系统 解锁 界面 .小 插件 也 进行 了 重新 设计 ,最 特别 的 就 是 系 
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统 的 任务 管理 器 可 以 显示 出 程序 的 缩 略图 ,便于 用 户 准确 快速 地 关闭 无 用 的 程序 。 

对 Android 来 说 ,最 大 的 特点 就 是 具有 开源 性 。 其 特点 在 于 改变 以 往 由 少数 软件 大 厂 垄 
断 系 统 软 件 平台 的 现 况 ,让 众多 内 容 开 发 商 和 开放 软件 供 货 商 来 分 享 共 同 利益 , 极 大 地 增进 了 
客户 使 用 经 验 。 这 是 Android 系统 市 场 份额 大 力 攀 升 的 原因 之 一 。 

纵览 Android 发 展 历程 ,在 这 短 短 的 三 年 多 时 间 里 ,Android 系统 的 发 展 经 历 了 翻天 覆 地 
的 变化 。 在 这 高 速 的 成 长 过 程 中 ,也 存在 一 些 问 题 。 例 如 ,由 于 其 开源 性 导致 衍生 版 本 过 于 混 
乱 、 终 端 设备 的 硬件 配置 良 劳 不 齐 , 使 得 Android 的 兼容 性 不 断 降低 ,给 开发 者 开发 应 用 程序 
带 来 了 很 大 的 不 便 ; 在 Android 3. 0 发 布 后 ,开源 与 否 就 成 了 争议 的 焦点 ,造成 了 Android P 
台 的 分 化 ,不 利于 Android 的 发 展 ; Android 的 应 用 程序 还 存在 着 一 些 安全 隐患 问题 。 对 于 这 
些 问题 ,还 需要 Google 从 政策 的 高 度 对 整体 进行 调控 ,从 市 场 的 角度 进行 引导 和 规范 。 


1.1.3 Android 主要 应 用 


Android 从 开始 的 手机 操作 系统 ,现在 发 展 成 为 移动 设备 (如 PDA, MID 产品 .平板 计算 
机 等 ) 的 操作 系统 ,在 这 个 系统 平台 上 可 以 开发 出 通信 定位, 餐饮、 娱乐 .商务 .家 电 控制 .行业 
服务 等 多 方面 的 既 实 用 又 有 吸引 力 的 移动 服务 应 用 。 其 中 ,手机 在 移动 互联 网 方面 的 应 用 是 
当前 发 展 的 主流 应 用 。 

如 图 1-1 所 示 是 一 个 由 中 国 互联 网 络 信息 中 心 (CNNIC) 于 2012 年 3 月 发 表 的 (中国 移动 
互联 网 发 展 状况 调查 报告 ) 中 的 统计 图 表 。 
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图 1-1 2010—2011 年 手机 网 民 网 络 应 用 
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在 移动 互联 网 应 用 方面 ,CNNIC 预测 : 手机 微 博 将 是 继 即 时 通信 之 后 ,又 一 个 吸引 网 民 
使 用 移动 互联 网 的 关键 应 用 。 首 先 ,相对 计算 机 来 说 ,手机 微 博 更 能 体现 微 博 内 容 的 随时 随地 
性 特点 ; 其 次 ,手机 微 博 更 能 发 挥 微 博 应 用 的 自 媒体 优势 ,例如 即兴 拍摄 的 图 片 、 视 频 等 ,这 反 
映 出 手机 在 即兴 原创 内 容 方 面 的 能 力 远 远 高 于 计算 机 ; 第 三 ,手机 微 博 的 使 用 并 没有 给 用 户 
带 来 不 友好 的 阅读 体验 。 手 机 搜索 、 手 机 网 络 新 闻 、 手 机 发 帖 回 帖 \ 手 机 社交 网 站 、 手 机 邮件 等 
应 用 是 与 手机 即时 通信 一 样 的 传统 手机 应 用 ,2011 年 同比 使 用 率 均 有 小 幅度 的 提升 。 

将 来 主要 的 应 用 推动 方向 在 于 : 手机 视频 娱乐 类 应 用 。 手 机 视频 作为 典型 的 娱乐 类 应 
用 ,使 用 率 变化 不 大 。 短 期 内 手机 视频 业务 发 展 主要 面临 以 下 困难 : 一 方面 ,无 线 网 络 基础 设 
施 不 能 满足 用 户 需求 ,视频 应 用 需要 消耗 大 量 的 无 线 网 络 流量 , 现 阶段 无 线 网 络 资费 较 高 , 且 
带宽 不 稳定 ,成 为 阻碍 这 类 应 用 发 展 的 瓶颈 ; 另 一 方面 ,手机 视频 相应 的 内 容 较为 缺乏 。 

电子 商务 类 应 用 普遍 处 于 发 展 初 期 ,在 手机 网 民 中 渗透 率 较 低 ,主要 原因 为 ,一 方面 ,大 部 
分 电子 商务 产品 , 均 需 要 用 户 进行 比较 ,咨询 后 才能 完成 购买 ,手机 较 小 的 屏幕 使 得 购物 体验 
相对 较 差 ; 另 一 方面 ,大 部 分 用 户 还 未 建立 起 对 手机 支付 的 信任 和 使 用 习惯 。 

由 此 可 以 看 出 ,Android 应 用 开发 将 大 有 作为 。 


E Android 框架 简介 


Android 平台 采用 了 整合 的 策略 思想 ,包括 底层 Linux 操作 系统 .中 间 层 的 中 间 件 和 上 层 
的 Java 应 用 程序 。Android SDK 提供 了 必需 的 工具 和 进行 应 用 开发 所 必需 的 Java 接 
口 API。 


1.2.1 Android 平台 特点 


Android 平台 用 户 数量 能 在 短 时间 内 迅速 激增 与 它 所 具有 的 特点 分 不 开 。 从 其 架构 的 角 
度 来 看 ,Android 平台 具有 以 下 几 个 特点 。 


1. 开放 性 


谈 到 Android 平台 的 特点 首先 就 是 其 开放 性 。 首 先 从 Android 源码 上 开放 ,使 得 每 一 个 
应 用 程序 可 以 调用 其 内 部 的 任何 核心 应 用 源码 ; 其 次 是 平台 上 开放 ,Android 平台 不 存在 任 
何 阻碍 移动 产业 创新 的 专 有 权限 制 ,任何 联盟 厂商 都 可 以 根据 自己 的 需要 自行 定制 基于 
Android 操作 系统 的 手机 产品 ; 再 次 是 运营 上 开放 ,手机 使 用 什么 方式 接 人 什么 网 络 ,已 不 再 
依赖 运营 商 的 控制 ,用 户 可 以 更 加 方便 地 连接 网 络 ; 等 等 。 这 些 显著 的 开放 性 可 以 使 其 拥有 
更 多 的 开发 者 , 随 着 用 户 和 应 用 的 日 益 丰 富 ,一 个 革新 的 平台 也 将 很 快走 向 成 熟 。 


2. 应 用 程序 平等 


在 Android 平台 中 ,其 内 部 的 核心 应 用 和 第 三 方 应 用 是 完全 平等 的 ,用 户 能 完全 根据 自己 
的 喜好 使 用 它们 来 定制 手机 服务 系统 ; 其 应 用 程序 框架 支持 组 件 的 重用 与 替换 ,程序 员 可 以 
完全 平等 地 调用 其 内 部 核心 程序 或 第 三 方 应 用 程序 。 


3. 支持 丰富 的 硬件 
Android 平台 支持 丰富 的 硬件 ,这 一 点 还 是 与 Android 平台 的 开放 性 相关 ,由 于 Android 
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的 开放 性 ,众多 的 厂商 会 推出 千奇百怪 功能 特色 各 异 的 多 种 产品 。 
4. 众多 的 开发 商 


Android 平台 提供 给 第 三 方 开 发 商 一 个 十 分 宽泛 、 自 由 的 环境 ,因此 不 会 受到 各 种 条 条 框 
框 的 阻挠 ,可 想 而 知 ,会 有 多 少 新 颖 别致 的 软件 诞生 。 但 与 此 同时 ,也 有 些 不 健康 的 、 恶 意 的 程 
序 和 游戏 出 现 ,如 何 控制 它们 正 是 Android 的 难题 之 一 。 


5. 强大 的 Google 应 用 


从 搜索 巨人 到 全 面 的 互联 网 渗透 ,Google 服务 如 地 图 .邮件 、 搜 索 等 已 经 成 为 连接 用 户 和 
互联 网 的 重要 纽带 ,而 Android 平台 手机 将 无 颖 结合 这 些 优秀 的 Google 服务 。 


1.2.2 Android 平台 架构 


Android 是 一 个 开放 的 软件 系统 ,为 用 户 提供 了 丰富 的 移动 设备 开发 功能 。 其 平台 架构 
从 下 至 上 包括 4 个 层次 ,如 图 1-2 所 示 。 


APPLICATIDNS 


Phone 


APPLICATION FRAMEWORK 


View Notification 
stem Manager 


Telephony n num XMPP Serv 
- Mon MPP Service 


LIBRARIES ANDROID RUNTIME 


Surface Manager ire Core 


OpenGLIES e 'ebKi Machine 


SGL 


LiNUX KERNEL 


Display Bluetooth Binder (IPC) 
D Driver Drive 


USB Driver 


图 1-2 Android 操作 系统 的 体系 结构 


从 图 1-2 可 以 看 出 ,Android 操作 系统 的 体系 结构 由 上 到 下 依次 是 应 用 程序 、 应 用 程序 框 
架 、 系 统 运行 库 和 Linux 内 核 , 其 中 第 三 层 还 包括 Android 运行 时 的 环境 。 下 面 分 别 来 讲解 各 
个 部 分 。 


1. 应 用 程序 


Android 平台 不 仅 是 操作 系统 ,也 预 装 了 一 组 核心 应 用 程序 ,包括 E-mail 客户 端 、 短 信服 
务 .日历 日 程 ` 地 图 服务 .浏览 器 .联系 人 和 其 他 应 用 程序 。 所 有 应 用 程序 都 是 Java 编程 语言 
编写 的 。 

不 仅 如 此 ,这 些 应 用 程序 都 是 可 以 被 程序 员 用 自己 编写 的 应 用 程序 所 替换 ,这 点 不 同 于 其 
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他 手机 操作 系统 固化 在 系统 内 部 的 系统 软件 ,Android 系统 更 加 灵活 和 个 性 化 。 这 个 替换 的 
机 制 实际 是 应 用 程序 框架 来 保证 的 。 


2. 应 用 程序 框架 


应 用 程序 框架 层 是 从 事 Android 开发 的 基础 ,上 面 所 提 的 核心 应 用 程序 就 是 依赖 框架 层 
次 API 开 发 的 。 应 用 架构 设计 的 初衷 是 : 简化 组 件 重 用 机 制 ; 任何 应 用 都 能 发 布 自己 的 功 
能 ,这 些 功能 又 可 以 被 任何 其 他 应 用 使 用 (当然 要 受 来 自 框 架 的 强制 安全 规范 的 约束 )。 和 重 
用 机 制 相同 ,框架 允许 组 件 的 更 换 。 在 这 个 应 用 程序 框架 中 ,程序 员 可 以 直接 使 用 其 提供 的 组 
件 来 进行 快速 的 应 用 程序 开发 ,也 可 以 通过 继承 而 实现 个 性 化 的 拓展 。 

所 有 应 用 框架 都 是 一 组 服务 和 系统 ,一 般 包含 以 下 几 部 分 。 

A) View System( 视 图 系统 )。 一 套 丰 富 且 可 扩展 的 视图 组 件 ,可 以 用 来 构建 应 用 程序 ， 
它 包 括 列表 (lists)、 网 格 (grids) , X% HE (text boxes) .按钮 (buttons) 以 及 嵌入 的 网 络 浏览 
器 等 。 

(2) Content Providers( 内 容 提供 器 )。 使 一 个 应 用 可 以 访问 另外 一 个 应 用 的 数据 ,或 者 
使 一 个 应 用 内 部 可 以 共享 自身 数据 。 例 如 手机 中 的 联系 人 信息 。 

(3) Resource Manager( 资 源 管 理 器 ) 。 提 供 对 非 编码 资源 的 访问 通道 。 例 如 本 地 化 字符 
串 .图 片 和 布局 文件 等 。 

(4) Notification Manager( 通 知 管理 器 ) 。 将 应 用 的 消息 显示 在 状态 栏 中 ,给 用 户 以 警报 
或 通知 。 

(5) Activity Manager( 行 动 管 理 器 ) 。 负 责 管理 应 用 的 生命 周期 ,提供 常用 导航 回 退 
支持 。 

(6) Window Manager( 窗 口 管理 器 ) 。 管 理 所 有 的 窗口 程序 。 

(7) Package Manager( 包 管理 器 ) 。Android 系统 内 的 程序 管理 。 

(8) Telephony Manager( 电 话 管理 器 ) 。 管 理 所 有 的 移动 设备 功能 。 


3. 系统 运行 库 


从 图 1-2 中 可 以 看 出 ,系统 运行 库 层 可 以 分 成 两 部 分 ,分 别 是 系统 库 和 Android 运行 时 。 

1) 系统 库 

Android 包含 一 套 C/C++ 库 ,Android 系统 的 各 个 组 件 都 在 使 用 ,这 些 功能 是 通过 Android 
应 用 框架 暴露 给 开发 人 员 的 。 系 统 库 是 应 用 程序 框架 的 支撑 ,是 连接 应 用 程序 框架 层 与 
Linux 内 核 层 的 重要 纽带 。 其 主要 核心 库 包括 以 下 几 部 分 。 

(D) Libc( 系 统 C 库 )。 一 个 从 BSD 继承 来 的 标准 C 系统 函数 库 ,专门 为 基于 Embedded 
Linux 的 设备 定制 。 

(2) Media Framework (多 媒体 库 )。Android 系统 多 媒体 库 , 基于 PacketVideo 
OpenCORE。 该 库 支持 录放 ,并 且 可 以 录制 许多 流行 的 音频 视频 格式 ,还 有 静态 映像 文件 , 包 
括 MPEG4,H. 264, MP3, AAC,JPG,PNG 等 。 

(3) Surface Manager。 主 要 负责 管理 针对 显示 系统 的 访问 ,并 且 为 多 个 应 用 程序 提供 2D 
和 3D 图 层 的 无 颖 融合 。 

(4) Webkit 浏览 器 。 一 个 最 新 的 Web 浏览 器 引擎 ,用 来 支持 Android 浏览 器 和 一 个 可 恋 
入 的 Web 视图 。 
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(5) SGL。 一 个 内 置 的 2D 图 形 引擎 。 

(6) SSL。 位 于 TCP/IP 与 各 种 应 用 层 协 议 之 间 ,为 数据 通信 提供 支持 。 

(7) OpenGL ES。3D 效果 的 支持 。 基 于 OpenGL ES 1. 0 APIs 实现 ; 该 库 可 以 使 用 硬件 
3D 加 速 (如 果 可 用 ) 或 者 使 用 高 度 优 化 的 3D 软 加 速 。 

(8) FreeType。 提 供 位 图 (bitmap) 和 向 量 (vector) 的 字体 描述 与 显示 。 

(9) SQLite。 一 个 对 于 所 有 应 用 程序 可 用 、 功 能 强劲 的 轻型 关系 型 数据 库 引 擎 。 

2) Android 运行 时 

Android 应 用 程序 时 采用 Java 语言 编写 ,程序 在 Android 运行 时 中 执行 ,其 运行 时 分 为 核 
心 库 和 Dalvik 虚拟 机 两 部 分 。 

(1) 核心 库 。 核 心 库 提供 了 Java 语言 API 中 的 大 多 数 功能 ,同时 也 包含 Android 的 一 些 
核心 API, 如 android. os,android. net, android. media 等 。 

(2) Dalvik 虚拟 机 。Android 程序 不 同 于 J2ME 程序 ,每 个 Android 应 用 都 运行 在 自己 的 
进程 上 ,享有 Dalvik 虚拟 机 为 它 分 配 的 专 有 实例 ,并 在 该 实例 中 执行 。Dalvik 虚拟 机 是 一 种 
基于 寄存 器 的 Java 虚拟 机 ,而 不 是 传统 的 基于 栈 的 虚拟 机 ,并 进行 了 内 存 资源 使 用 的 优化 以 
及 支持 多 个 虚拟 机 的 特点 。Java 编译 器 将 Java 源 文 件 转 为 class XPF, class 文件 又 被 内 置 的 
dx 工具 转化 为 dex 格式 文件 ,该 格式 文件 针对 最 小 内 存 使 用 做 了 优化 ,这 种 文件 在 Dalvik 虚 
拟 机 上 注册 并 运行 。 在 一 些 底层 功能 方面 ,例如 线程 和 低 内 存 管理 等 ,Dalvik 虚拟 机 是 依赖 
Linux 内 核 的 。 


4. Linux 内 核 


Android 是 基于 Linux 2.6 内 核 ,由 C 语言 实现 。 其 核心 系统 服务 如 安全 性 、 内 存 管理 、 
进程 管理 ,网 路 协议 以 及 驱动 模型 都 依赖 于 Linux 内 核 。 内 核 部 分 还 相当 于 一 个 介 于 硬件 层 
和 系统 中 其 他 软件 组 之 间 的 一 个 抽象 层次 。 

除了 标准 的 Linux 内 核 外 ,Android 系统 还 增加 了 Binder IPC 驱动 .WiFi 驱动 .蓝牙 驱动 
等 驱动 程序 , 为 系统 运行 提供 了 基础 性 支持 。 


(à Android 环境 搭建 


Android 软件 开发 包 可 以 在 Windows( 如 Windows XP, Vista 或 Windows 7), Linux 和 
Mac OSX 上 安装 运行 。 然 后 将 在 这 些 操作 系统 中 开发 的 Android 应 用 程序 部 署 到 任意 的 
Android 设备 上 。 

Android 软件 开发 包 主要 包括 JDK Eclipse 和 Android SDK ,在 进行 应 用 程序 开发 之 前 ， 
首先 必须 将 开发 环境 搭建 起 来 。 本 书 介绍 的 是 在 Windows 操作 系统 下 搭建 开发 环境 ,执行 开 
发 编程 。 


1.3.1 下 载 Android 开发 工具 


要 在 Windows 操作 系统 上 开发 Android 应 用 项 目 ,必须 要 有 三 个 工具 软件 : DJDK， 
Android 主要 使 用 Java 语言 来 开发 应 用 程序 ,所 以 必须 要 有 JDK 开发 包 ; QO Eclipse. Eclipse 
是 常用 的 Java 语言 的 集成 开发 环境 ; @SDK,.SDK 是 Software Development Kit 的 缩写 ,是 
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专门 用 于 开发 Android 应 用 的 软件 开发 工具 包 。 

JDK, Eclipse 和 SDK 这 三 个 工具 软件 可 以 从 一 些 专业 网 站 中 免费 下 载 。 由 于 现代 软件 
行业 的 发 展 变化 ,以 及 这 些 软件 版 本 的 不 断 升 级 ,其 下 载 网 址 和 文件 名 ,以 及 安装 配置 过 程 都 
有 可 能 会 发 生变 化 。 本 书 所 介绍 的 工具 软件 及 开发 环境 是 至 2012 年 6 月 ,最 新 的 下 载 软件 及 
环境 搭建 , 供 大 家 在 实践 中 参考 。 


1. 下 载 JDK 


从 网 址 为 http://www. oracle. com/technetwork/java/javase/downloads/index. html 的 
网 页 中 ,下 载 Java SE 的 开发 工具 包 JDK ,如 图 1-3 所 示 。 


Ovewew | Downloads  Documeniaton | Communty | Technologies | Traning 
Java SE Downloads 


Š javr 二 javafX ® Netbeans = Java 
pem 
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javasejdonrios 


图 1-3 Oracle 技术 网 站 的 Java 下 载 网 页 


选择 在 Java Platform. Standard Edition 中 的 Java SE 7u5 的 JDK 下 载 , 即 单 击 如 图 1-3 
所 标记 的 DOWNLOAD 按钮 ,进入 下 载 细 目 页 。 在 下 载 细 目 中 选择 适用 Windows 的 文件 下 
载 : 如 果 计 算 机 操作 系统 是 32 位 的 ,下 载 jdk-7u5-windows-i586. exe; 如 果 计 算 机 操作 系统 
是 64 位 的 ,下 载 jdk-7u5-windows-x64. exe。 本 书 选择 的 是 下 载 jdk-7u5-windows-i586. exe XC 
件 , 保 存在 本 机 的 文件 夹 中 。 


2. 下 载 Eclipse 


在 网 址 为 http://www. eclipse. org/downloads/ 的 网 页 中 ,选择 要 下 载 的 Eclipse 工具 。 
如 果 是 开发 不 用 配置 Tomcat 网 络 服务 器 的 应 用 程序 ,可 以 选择 Eclipse IDE for Java 
Developers 项 下 载 ,如 果 应 用 程序 需要 使 用 到 Tomcat 网 络 服务 器 ,建议 选择 Eclipse IDE for 
Java EE Developers 项 。 本 书 选择 后 者 , 单 击 Eclipse IDE for Java EE Developers 项 进入 下 载 
细 目 网 页 ,如 图 1-4 所 示 。 

Eclipse 有 不 同 的 下 载 包 ,如 图 1-4 左边 窗口 中 列 出 的 Indigo、Helios、Galileo 等 。 本 书 选 
择 的 是 Helios Packages。 单 击 Helios Packages, 进 入 文件 下 载 页 ,选择 Eclipse IDE for Java 
EE Developers 项 后 面 的 Windows 32-bit, 进 入 如 图 1-5 所 示 的 下 载 镜像 页 ,然后 单 击 下 载 图 
标 , 即 可 下 载 eclipse-jee-helios-SR2-win32. zip, 将 该 文件 保存 在 本 机 的 文件 夹 中 。 
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1-5 Eclipse 的 下 载 镜像 页 


3. 下 载 SDK 


输入 网 址 http://developer. android. com/sdk/index. html 进入 Android 的 开发 工具 网 
页 ,如 图 1-6 所 示 。 单 击 右边 窗口 的 Download the SDK for Windows 项 , 即 可 下 载 或 运行 来 
自 dl. google. com 的 installer r18-windows. exe。 本 书 选 择 的 是 保存 该 文件 到 文件 夹 中 。 

现在 已 经 将 需要 的 三 个 工具 软件 下 载 完 毕 ,保存 在 E:\3gms\android_downloads\2012 
文件 夹 中 ,如 图 1-7 所 示 。 
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1.3.2 开发 环境 的 安装 与 配置 
1. 安装 JDK 


运行 下 载 的 jdk-7u5-windows-i586. exe 文件 ,出 现 如 图 1-8 所 示 的 安装 向 导 。 
按照 向 导 逐 步 完 成 安装 。 本 书 中 将 其 安装 在 C:\Program Files\Java\jdk1. 7.0_05 文件 
夹 中 。 为 了 检查 JDK 安装 是 否 成 功 , 可 使 用 如 下 方法 进行 检验 。 


(1) 单 击 “ 开 始 " 菜 单 , 选 择 “ 运 行 .… ”菜单 项 ,在 “运行 ”对话 框 中 输入 “cmd” 


令 行 状态 。 
(2) 在 命令 行 状 


JE) Java SE Development Kit 7 Update 5 - 


Java: ORACLE 


欢迎 使 用 Java SE Development Kit 7 Update 5 安装 向 导 


此 问号 将 引导 您 完成 Java SE Development Kit 7 Update 5 的 安装 过 程 。 


在 JK 安 装 后 , 将 安装 JavaFX 2.1SDK 。 


TNR 


cn 


Lr] 


图 1-8 安装 JDK 的 向 导 
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P A 


,进入 命 


hi 


发 起 步 


态 提 示 符 后 输入 命令 :“java -version”, 然 后 按 Enter 键 。 如 果 得 到 如 
图 1-9 所 示 的 信息 , 则 表示 安装 成 功 。 


Erg 管理 员 : CAWindows|system32Wmd.exe 


[Java Ho 


otSpot(TM) Client UM (build 23.1-b03, sharing) 


(c: Nisers Vidninistrator?,, 


2. 安装 Eclipse 


图 1-9 检验 JDK 安装 的 成 功 信息 


Eclipse 不 需要 安装 ,直接 解压 eclipse-jee-helios-SR2-win32. zip 文件 到 指定 的 文件 夹 中 


即 可 。 本 书 将 其 解压 


3. 安装 SDK 


在 E:\Eclipse 文件 夹 下 。 


运行 下 载 的 installer r18-windows. exe 文件 ,可 能 会 出 现 一 个 无 法 验证 发 布 者 的 安全 警 


告 窗 ,这 个 程序 来 自 


F Google, 单 击 “ 运 行 ”按钮 ,进入 安装 向 导 , 如 图 1-10 所 示 。 


单 击 Next 按钮 进入 安装 页 ,在 安装 SDK 前 ,程序 会 先 检测 计算 机 是 否 已 安装 了 JDK。 


11 


12 


P: 
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在 前 面 已 经 安装 好 了 JDK, 所 以 单 击 Next 按钮 ,逐步 按照 向 导 提 示 进 行 操作 ,直到 完成 ,如 
图 1-11 所 示 。 本 书 的 SDK 安装 路 径 为 E:\android-sdk。 
(B) Android SDK Tools Setup. copo ameti 


be mim 


(B) Android SDK Tools Setup. 


Welcome to the Android SDK Tools 
Setup Wizard 


Completing the Android SDK Tools 
Setup Wizard 


Ths wizard vil ide you through the nstalaton of Androd Android SOK Tools has been instaled on your computer. 
SDK Tools 
Cick Finish to dose this wizard. 
Iti recommended that you dose al other appkcatons 
before starbng Setup. The wi make it possbie to update 
relevant system fies without havng to reboot your 
pe VI start SDK Manager (to donrioad system images, etc.) 


Ck Next to contrue. 


Cens) [ee ] NN 
图 1-10 安装 SDK 的 向 导 图 1-11 安装 完成 


在 完成 安装 SDK 之 后 ,需要 对 该 Android SDK 兼容 的 各 种 版 本 进行 下 载 ,升级 和 更 新 ， 
所 以 在 图 1-11 "P 4i T Start SDK Manager(to download system images, etc. ) ,然后 单 击 
Finish 按钮 。 然 后 进入 SDK 管理 程序 ,如 图 1-12 所 示 。 


Android SDK Ma 
|| Packages Tools 


SDK Path: andi 
Packages 
Name API Rev. Status 
E Tools 
X Android SDK Tools 18 4 Update available: rev. 19 
W Android SDK Platform-tools 11 $ Notinstalled 


Android 4.0.3 (API 15) 
Android 40 (API 14) 
Android 3.2 (API 13) 
Android 3.1 (API 12) 
Android 30 (API 11) 
Android 2.3.3 (API 10) 
Android 22 (API 8) 
Android 2.1 (API 7) 
Android 16 (API 4) 


Show: [V|Updates/New [F] Installed Obsolete Select New or Updates 


Sort by: & API level Repository 


———— ——— 
mn 
Fetching URL: http://dl.htcdev.com/sdk/addon.xml 


图 1-12 Android SDK Manager 对 话 框 


SDK Manager 首先 会 搜索 一 遍 本 机 中 的 SDK 版 本 的 安装 情况 , 待 搜索 完毕 ,可 以 看 到 原 
来 的 Install packages... 按 钮 变 成 了 Install 60 packages... ,这 说 明 有 60 个 安装 包 需 要 从 网 络 
上 下 载 安装 ,当然 ,可 以 通过 勾 选 或 不 勾 选 部 分 Android SDK 版 本 的 项 目 , 此 时 按钮 中 的 数字 
会 随 之 变化 。 单 击 该 按钮 进入 Choose Packages to Install 对 话 框 ,如 图 1-13 所 示 。 

在 此 选择 Accept ATL 单 选 按钮 ,当然 .也 可 以 选择 Accept 或 其 他 单 选 按钮 ,然后 单 击 
Install ,进行 下 载 和 安装 。 在 安装 过 程 中 有 时 会 弹出 一 些 对 话 框 , 可 以 选择 继续 下 去 ,有 些 可 
能 需要 输入 密码 等 信息 ,这 是 因为 SDK 3. 0 版 本 以 后 ,有 些 资 源 不 是 完全 开放 的 ,这 时 一 般 
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Packages Rn 
M Android SDK Tools, revision 19 ~ 
V Android SDK Platform-tools, revsio.. 5| Android SDK Tools, revision 19 
V Documentation for Android SDK, A... 
~ SDK Platform Android 4.0.3, API 15,- 
V SDK Platform Android 40 API 14, .. DESEE 

V SDK Platform Android 3.2, API 13, .. Installing this package also requires installing: 
V SDK Platform Android 3.1, API 12, r- ~ Android SDK Platform-tools, revision 11 

V SDK Platform Android 3.0, API 11, r- is eus 
~ SDK Platform Android 2.3.3, APL10.. "| © Accept © Reject 


This update will replace revision 18 with revision 19. 


[*] Something depends on this package 


1-13 Choose Packages to Install 对 话 框 


可 以 不 安装 这 些 packages。 注 意 , 这 个 过 程 持续 时 间 比 较 长 ,请 耐心 等 待 ,并 保持 网 络 的 
畅通 。 

安装 完毕 后 ,请 关闭 Android SDK Manager 窗口 ,然后 再 次 打开 它 ,看 看 需要 安装 的 包 是 
否 已 经 成 功 安装 。 


4. 安装 Eclipse 插件 ADT 


这 时 的 Eclipse 还 不 能 开发 Android 应 用 程序 ,必须 在 安装 了 ADT (Android 
Development Toolkit) 插 件 后 才能 进行 Android 应 用 开发 。ADT 插件 在 Eclipse 中 集成 的 功 
能 有 : 新 建 项 目 向 导 , 并 且 包 含 基本 的 应 用 向 导 , 基 于 表单 的 manifest, layout 和 resource 编 
辑 器 ,自动 编译 Android 项 目 ,Android 模拟 器 ,Dalvik 调试 监控 服务 (DDMS) ,访问 设备 或 模 
拟 器 的 文件 系统 ,运行 时 调试 ,所 有 的 Android/Dalvik 日 志和 控制 台 输 出 等 。 所 以 , 想 要 在 
Eclipse 中 开发 Android 应 用 程序 ,需要 安装 ADT 插件 。 

其 操作 步骤 如 下 。 

(1) 启动 Eclipse。 

注意 ,首次 启动 Eclipse 时 会 出 现 一 个 加 载 工作 空间 的 对 话 框 ,如 图 1-14 所 示 。 

Ecco NN NN C7 


Select a workspace 


Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


Workspace: EMndroidCode m 


[V] Use this as the default and do not ask again 


[ec )[ em] 


图 1-14 设置 项 目的 工作 路 径 


NA 
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在 这 个 对 话 框 中 ,可 以 设置 应 用 项 目的 工作 路 径 , 如 果 不 想 每 次 启动 Eclipse 都 出 现 此 对 
话 框 ,可 以 勾 选 Use this as the default and do not ask again 项 。 然 后 单 击 OK 按钮 ,首次 启动 
Eclipse 时 会 出 现 欢迎 界面 ,如 图 1-15 所 示 。 以 后 再 次 启动 Eclipse 就 不 会 出 现 这 个 欢迎 界 
面 ,而 是 直接 进入 Eclipse 工作 界面 ,如 图 1-16 所 示 。 


File Edit Refactor Rum Navigate Search Projet Window Help 


Eclipse Java EE IDE for Web Developers 


(^ Overview Tutorials 
| ee c ruso 
Qu Samples ^. What's New 


Ww — Try out the samples. 


N 


Find out what is new 


1-15 Eclipse 的 欢迎 界面 


TO Project Explorer © =a = GS ortine wk] "5 


I, C3 Properties BB Data Source Explorer. 15 Snippets Rial: 


Description z Resource Path Location Type 


Æ 1-16 Eclipse 的 工作 界面 
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(2) 添加 Site. 
选择 菜单 Help — Install New SoftWare..., 进 入 Install 对 话 框 ,如 图 1-17 所 示 。 


(E sean J 
Available Software 
| Select a site or enter the location of a site. 
Won vin TEE i E 
Fed more eere by woding with the kie So pope 
type fiter text 
Ja de n — 
E O There is no site selected. 
Details. 
[VI Show only the latest versions of available software [E Hide items that are already installed 
II Group items by category What is already installed? 
H] Contact all update sites during install to find required software 
[9] < Back Next > Finish | [ECecsa 


图 1-17 Install 对 话 框 


单 击 图 1-17 中 标记 处 的 Available Software Sites, 进入 Preferences 对 话 框 ,如 图 1-18 
所 示 。 


Available Software Sites 二 


cson n 

Helios httpy/download echipse.org/releases/heios 

|Myhy for Eclipse Helios hapy/downioad eciipse.org/tools/mylyr/ur' [s ] 
IV) The Edipse Project Updates  http//download.ecipse.org/eclipse/u | 
EZ Sl The Ecipse Web Tools Platform.. http://downlosd.ecipse.org/webtools/repo 
E htp/devecipseorg/swroot/dsdp/orgec | | Reload 
BA Þttpy/download.ecipse.org/birt/update-sit | - 
n " hitp//download.ecipseorg/datatools/upd. | | — Enable 
[a] http//download.ecipse.org/dsdp/mti/upde 
BA http:J/download.eciipse.org/dsdp/mti/updz [amen ] 
BA httpil/download.ecipseorg/dsdpAtm/upda |^ Export. 
DA http//download.ecipse.org/egit/updates 
E http//download echipse.org/mat/1.0/updat 
E http./download ecipse.oro/modeling/em, 
Ed http/download.ecipse.org/modeling/eml; 
E hitpijdownload.eciipse.org/modeling/emf ~ 
B D 

Ce Jem JI 


图 1-18 Preferences 对 话 框 
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单 击 Add 按钮 ,进行 添加 可 用 的 下 载 插件 的 站 点 Site 设置 ,如 图 1-19 所 示 。 


A sre 


Name: — Android Development Tools 


Location: Mtpsd-sslgooglecom/android/edipse] | 


(o [oy] C ome] 


图 1-19 Add Site 对 话 框 


在 此 对 话 框 中 输入 站 点 的 名 字 , 该 名 字 由 用 户 自己 定义 ,可 以 随便 命名 。 在 这 里 输入 
“ Android Development Tools”, 该 站 点 所 在 的 网 址 “http://dl-ssl. google. com/android/ 
eclipse”, 然 后 单 击 OK 按钮 , 即 可 以 在 Preferences 对 话 框 的 右边 看 到 新 添加 的 Site 了 。 单 击 


Preferences 对 话 框 中 的 OK 按钮 返回 到 Install 对 话 框 。 
(3) 下 载 并 安装 插件 。 


在 Install 对 话 框 的 Work with 下 拉 列 表 中 选择 刚 创 建 的 Site 项 ,然后 在 type filter text 
的 下 面 ,展开 Developer Tools 可 以 看 Android DDMS、 Android Development Tools、Android 


Hierarchy Viewer 等 项 目 , 勾 选 它们 ,如 图 1-20 所 示 。 


| G8] Install 
Available Software 
||. Check the items that you wish to install 


Work with: Android Development Tools - http.//dl-ssl.google.com/android/eciipse/ 


mum 


Find more software by working with the "Available Software Sites" preferences. 


[E Contact all update sites during install to find required software 


ype filter text 
Name Version " 
4 [V] 100 Developer Tools 
Qj. Android DDMS 18.0.0.v201203301601-306762 
3 Android Development Tools 18.0.0.v201203301601-306762 
3 Android Hierarchy Viewer 18.0.0.v201203301601-306762 
Vi @ Android Traceview 18.0.0.v201203301601-306762 ad 
selest Alss| uDeselechMMg| — 4 ems selected 
Details 
[V] Show only the latest versions of available software E Hide items that are already installed 
Group items by category What is already installed? 


poem] 


Qo [< Back atietan] | Finish 


图 1-20 选择 Work with 项 , 勾 选 type filter text 下 面 的 所 有 项 


单 击 Next 按钮 ,进入 显示 所 要 安装 插件 的 细节 内 容 的 页 面 ,如 图 1-21 所 示 。 


继续 单 击 Next 按钮 ,进入 确认 安装 插件 页 面 ,如 图 1-22 所 示 。 
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Ea 
Install Details 
Review the items to be installed. 
Name Version Id 
GÈ Android DOMS 180.020120330.. com.android.ide.eclipse.ddms.feature.... 
G Android Development Tools 180.020120330.. com.android.ide.eclipse.adt feature.gr... 
Q Android Hierarchy Viewer 18.0.0.v20120330.. com.android.ide.eclipse.hierarchyview... 
G Android Traceview 18.0.0.v20120330.. com.android.ide.eclipse.traceview.feat... 
Size: Unknown 
Details 
@ Er Finish ] (encala) 
图 1-21 显示 所 要 安装 的 插件 细节 页 面 
EE 一 
Review Licenses 
licenses must be reviewed and accepted before the software can be installed. 
Licenses: License text: 
Apache License. ^ 


Note: jommon-112jar is under the BSD license rather than the A 
Note: kxml2-2.3.0jar is under the BSD license rather than the EPL. 


® 1 accept the terms of the license agreements 
— ed » | ©1do nct accept the terms of the license agreements 


© M ee itara ia 
图 1-22 确认 安装 插件 页 面 


选择 I accept the terms of the license agreements 单 选项 ,然后 单 击 Finish 按钮 ,开始 下 
载 和 安装 ADT 插件 。 在 安装 过 程 中 会 弹出 一 些 警 告 提示 框 , 单 击 OK 按钮 继续 安装 。 
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安装 完成 后 ,出现 重新 启动 Eclipse 对 话 框 ,如 图 1-23 所 示 。 
Hi sor Uoc RR RR 


e You will need to restart Eclipse for the installation changes to take effect. You 


may try to apply the changes without restarting, but this may cause errors. 


etie] [tetto | [eph Onoges tn 
1-23 ”安装 完成 后 的 对 话 框 

单 击 Restart Now 按钮 ,立即 执行 重启 Eclipse 操作 。 

5. 为 Eclipse 指认 SDK 


这 一 设置 的 目的 是 为 了 告诉 Eclipse Android 的 SDK 位 于 何 处 。 在 安装 ADT 插件 后 ， 
会 重启 Eclipse, WJA Eclipse 后 系统 会 自动 地 完成 指认 SDK 的 路 径 ,如 图 1-24 所 示 。 如 果 此 
时 SDK 中 有 需要 升级 的 版 本 包 , 系 统 还 会 自动 运行 SDK Manager 程序 进行 升级 安装 。 


Welcometo Android 


Welcome to Android Development 
Â The directory is not empty 


To develop for Android, you need an Android SDK, and at least one version of the Android APIs to 
compile against. You may also want additional versions of Android to test with. 


@ Install new SDK 
[F] Install the latest available version of Android APIs (supports all the latest features) 
回 Install Android 2.1, a version which is supported by ~97% phones and tablets 
(You can add additional platforms using the SDK Manager.) 


Target Location: EAandroid-sd Browse... 

| 一 一 
© Use existing SDKs 

Existing Location: Browse.. 


K (antait py] 一 ee 一 


图 1-24 自动 指认 SDK 的 位 置 


如 果 重 启 Eclipse 时 没有 自动 做 上 述 操作 ,可 以 手动 进行 设置 ,其 操作 步骤 如 下 。 

(1) 启动 Eclipse。 如 果 已 经 启动 了 Eclipse, 可 以 忽略 这 一 步 。 

(2) 指出 SDK 所 在 位 置 。 选 择 菜单 Window 一 Preferences ,在 左 侧 窗 口 的 列表 中 选择 
Android, 这 时 右 侧 窗口 显示 有 关 Android 的 Preferences。 在 SDK Location 输入 框 内 输入 
SDK 所 在 的 文件 夹 路 径 ,当然 也 可 以 通过 单 击 Browse... 按 钮 来 选择 SDK 所 在 的 文件 夹 路 
径 。 本 书 的 SDK 的 保存 路 径 是 下 :\android-sdk, 如 图 1-25 所 示 。 


6. 为 Eclipse 创建 AVD 


在 Eclipse 中 运行 Android 应 用 程序 ,必须 要 在 Eclipse 中 创建 AVD(Android Virtual 
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E 


E] 
||| type filter text Android ro 
| General <^ | Android Preferences ^ 
Android 
Build SDK Location:  EXandroid-sdk | [| Browse.. | 
DOMS Note: The list of SDK Targets below is only reloaded once you hit 'Apply or 'OK. 
Editors 
mu Target Name Vendor Platform — APIL. 
Unt Error Checkin, Android 1.5 Android Open Source Project. 15 3 
LogCat Google APIs Google Inc. 15 3 
Usage Stats Android 16 Android Open Source Project. 16 4 
Ant Google APIs Google Inc. 16 4 
Data Management Android 2.1 Android Open Source Project. 21 7 
Help Google APIs Google Inc. 21 7 
Install/Update Android 2.2 Android Open Source Project 22 8 
Java Google APIs Google Inc. 22 8 
Java EE DTS Add-On KYOCERA Corporation 22 8 
Java Persistence Reol3D Add on LGE 22 e 
JavaScript GALAXY Tab Addon Samsung Electronics Co., Ltd. 22 8 
Plug-in Development Android 233 Android Open Source Project 233 10 
Remote Systems Google APIs Google Inc. 233 10 
ue E Intel Atom x86 System ... Intel Corporation 233 10 
amm RO DTS Add-On KYOCERA Corporation 233 10 - 
[o] 


图 1-25 为 Eclipse 指出 SDK 的 所 在 位 置 


Device,Android 虚拟 设备 ) ,每 个 AVD 模拟 一 套 虚 拟 设 备 来 运行 Android 应 用 程序 。AVD 
又 称 为 Android 模拟 器 ,占用 PC 上 的 硬盘 空间 ,可 以 模拟 不 同 款 手机 设备 ,运行 效果 与 手机 
真 机 几乎 相同 。 可 以 创建 一 个 AVD, 也 可 以 创建 多 个 AVD。 

创建 AVD 的 方法 有 两 种 。 一 是 通过 命令 行 创建 ,二 是 通过 Eclipse 开发 环境 创建 。 

CD 使 用 命令 创建 AVD。 在 “开始 ”菜单 的 "运行...” 菜 单项 中 输入 命令 “cmd”, 进 入 命令 
行 状 态 , 在 提示 符 后 输入 以 下 命令 创建 AVD, 命 令 的 格式 为 : 


android create avd —— name < 名 字 > -- target < 版 本 ID 号 > 
例如 ,要 创建 一 个 名 为 avdl ,版 本 号 为 8 的 模拟 器 ,输入 命令 为 : 
android create avd —- name avdl -- target 8 


注意 ,这 里 的 android 命令 是 一 个 批 处 理 文件 , 它 存放 在 SDK 所 在 文件 夹 的 tools 子 文件 
夹 中 。 如 果 没 有 将 这 个 文件 夹 路 径 加 入 到 Windows 操作 系统 的 环境 变量 path 中 ,每 次 运行 
android 命令 都 必须 先进 入 tools 子 文件 夹 中 ,然后 才能 正常 运行 。 如 果 不 想 这 么 麻烦 ,建议 将 
tools 子 文件 夹 的 路 径 添加 到 环境 变量 path 中 。 另 外 ,还 有 些 SDK 中 的 命令 是 存放 在 SDK 
所 在 文件 夹 的 platform-tools 子 文件 夹 中 ,例如 adb, 所 以 也 建议 将 platform-tools 子 文件 夹 的 
路 径 添加 到 环境 变量 path 中 。 本 书 中 SDK 所 在 文件 夹 是 EE:\android-sdk, 以 Windows 7 为 
例 , 向 环境 变量 path 添加 路 径 的 操作 如 下 。 

(D 打开 “计算 机 ”, 选 择 工具 栏 中 的 “系统 属性 ”, 进 入 “控制 面板 ”一 “系统 和 安全 ”一 “ 系 
GE" f EI ,选择 左 侧 的 “高 级 系统 设置 ", 进 入 “系统 属性 ”页 的 “高 级 "选项 卡 。 
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© 单 击 “ 环 境 变 量 ... ”按钮 ,进入 “环境 变量 ”对 话 框 ,如 图 1-26 所 示 。 
O 在 “系统 变量 ”列表 框 中 选择 Path 变量 ,然后 单 击 “ 编 辑 ..…. ”按钮 ,进入 “编辑 系统 变量 ” 
对 话 框 ,在 “变量 值 ? 输 入 框 内 加 入 :“;E:\android-sdk\tools; E:\android-sdk\platform- 
tools”, 在 这 里 每 一 个 路 径 之 间 用 “; ?号 分 隔 。 然 后 单 击 “ 确 定 ? 按 钮 ,如 图 1-27 所 示 。 


Adninistrator PAARE U 
zE d 
TEMP USERPROFILES AppDat a\Local\Tenp 
E XUSERPROFTLEX AppData Local \Tenp 


Com 


系统 变量 O) 


变量 
UNDER, OF. PK. 
os 


Path 


E ED 


tools; E: \android-sdk\platforn-toold] 


1-26 “环境 变量 ”对话 框 1-27 “编辑 系统 变量 ?对话 框 


这 样 就 为 系统 环境 变量 Path 添加 了 两 个 子 文 件 夹 的 路 径 。 在 此 之 后 ,就 可 以 在 命令 行 状 
态 下 的 任何 目录 中 运行 包含 在 这 两 个 路 径 中 的 命令 了 。 

(2) 在 Eclipse 中 创建 AVD 的 步骤 如 下 。 

(D 在 Eclipse 中 ,选择 菜单 Window — AVD Manager. 进入 Android Virtual Device 
Manager 对 话 框 。 注 意 ,初始 创建 时 ,是 没有 任何 模拟 器 在 列表 中 的 。 

@ 单 击 New... 按 钮 ,进入 Create new Android Virtual Device(AVD) 对 话 框 开始 创建 一 
个 新 的 模拟 器 ,如 图 1-28 所 示 。 

在 此 对 话 框 中 ,输入 AVD 的 名 字 , 在 这 里 为 它 取 名 为 “AVD_and-23”。 在 Target 下 拉 框 
中 选择 Android 2. 3. 3 -API Level 10。 在 SD Card 中 的 Size 输入 框 内 输入 “1024”, 单 位 为 
MiB, 说 明 这 个 SD Card 的 存储 容量 为 1GB。 在 Skin 的 Built-in 下 拉 列 表 框 中 选择 HVGA, 
Built-in 中 的 选项 决定 了 模拟 器 屏幕 的 尺寸 ,HVGA 代表 屏幕 的 大 小 是 320X480 像素 。 

@ 单 击 Create AVD 按钮 ,开始 创建 模拟 器 。 

(3) 在 Eclipse 中 启动 AVD。 

(D 在 Eclipse 中 ,选择 菜单 Window — AVD Manager, 进入 Android Virtual Device 
Manager 对 话 框 。 在 模拟 器 的 列表 中 可 以 看 到 已 创建 的 AVD。 

@ 选择 需要 启动 的 AVD 项 ,这 里 选择 的 是 AVD_and-23 模拟 器 ,然后 单 击 Start... 按 钮 ， 
进入 Launch Options 对 话 框 ,如 图 1-29 所 示 。 

© 单 击 Launch 按钮 ,就 可 以 启动 所 选择 的 模拟 器 了 。 注 意 ,首次 启动 模拟 器 的 时 间 较 
长 ,如果 想 节 省 时 间 ,建议 在 刚 一 进入 Eclipse 的 时 候 就 启动 模拟 器 。 启 动 完成 后 的 模拟 器 如 
图 1-30 所 示 。 


Name: — AVD_and-23 
Target — [Android 23.3 -API Level 10 m 
| CPu/ABE. [ARM (armeabiy z 
SD Card: 
€ Size: 1024 
| 
| File: | Browse. 
| snapshot: 
El Enabled 
Skin: 
@ Buitim [Hye m 
© Resolution: | x 
Hardware: 
Property Value Newa 
Abstracted LCD density 160 
A Delete 
Max VM application h.. 24 
Device ram size 256 
C Override the existing AVD with the same name 
[ create ^n) Cancel 


图 1-28 创建 AVD 
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(S) Launch Options — 


Skin: — HVGA (320x480) 
Density: Medium (160) 
El Scale display to real size 


[E Wipe user data 


default 


Launch from snapshot 


Save to snapshot 


Ey Cea 


1-29 Launch Options 对 话 框 


1-30 Android SDK 2. 3. 3 的 模拟 器 
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T Android 的 第 一 个 应 用 


在 完成 Android 开发 环境 的 搭建 后 ,就 可 以 开始 进入 Android 的 应 用 开发 之 旅 了 。 本 节 
主要 介绍 Android 应 用 程序 的 创建 和 运行 。 


1.4.1 创建 一 个 Android 应 用 项 目 


在 Eclipse 开发 环境 下 创建 Android 应 用 项 目的 步骤 如 下 。 
(1) 打开 Eclipse. 选择 菜单 File New — Project..., 进 入 New Project 对 话 框 ,选择 
Android 下 的 Android Project, 如 图 1-31 所 示 。 


Select a wizard 


Wizards: 
type fiter text 


W$ Java Project 
XE Java Project from Existing Ant Buildfile 
3$ Plug-in Project 


六 Android Sample Project. 
JẸ Android Test Project 

^ g CVS 

» © Eclipse Modeling Framework 


图 1-31 New Project 对 话 框 


(2) 单 击 Next 按钮 ,进入 New Android Project 对 话 框 。 在 此 对 话 框 中 输入 Android 应 
用 项 目的 项 目 名 称 。Android 的 应 用 项 目 名 称 遵从 文件 夹 命名 规则 ,但 不 能 使 用 中 文 名 。 这 
里 为 这 个 应 用 项 目 起 名 为 HelloAndroid, 如 图 1-32 所 示 。 

(3) 单 击 Next 按钮 ,进入 新 建 项 目 选 择 SDK 版 本 页 ,如 图 1-33 所 示 。 

(4) 单 击 Next 按钮 ,进入 设置 项 目 参数 页 ,如 图 1-34 所 示 。 

在 该 页 中 的 Application Name 文本 框 中 输入 应 用 程序 名 “Hello, Android”。 在 Package 
Name 文本 框 中 输入 包 名 ,注意 ,这 个 包 名 必须 全 球 唯一 ,因为 当 应 用 项 目 发 布 时 ,有 许多 标识 
是 通过 包 名 来 区 分 的 ,当然 ,同一 个 大 的 项 目 或 同一 个 开发 人 员 可 以 为 自己 的 项 目 定义 相同 的 
包 名 ,但 前 提 是 不 能 有 相同 的 项 目 名 或 项 目 中 的 文件 名 。 在 Create Activity 文本 框 中 输入 初 
始 的 活动 类 名 “Hello”, 这 个 类 名 与 一 个 Java 代码 文件 名 一 致 , 当 项 目 运行 时 ,首先 运行 的 是 
这 个 类 。 注 意 , 这 个 活动 类 名 不 能 包含 空格 。 最 后 是 在 Minimum SDK 文本 框 中 输入 最 小 版 
本 号 ,输入 最 小 版 本 号 是 为 了 定义 项 目的 兼容 性 ,也 意味 着 新 建 项 目 能 在 SDK 的 哪个 版 本 以 
上 正常 运行 。 
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(8 New Android Proje ) 
| Select Build Target © 
Select project name and type of project Choose an SDK to target 
Project Name: HelloAndroid| Build Target 
® Create new project in workspace Target Name Vendor Platform API. 二 
© Create project from existing source (E Android 15 Android Open Source Projet — 15 3 
© Create project from existing sample E Google APIs Google Inc. is 3 
Use defeuk location El Android 16 Android Open Source Projet 16 4 
= Fi Google APIs Je Inc. 16 4 
Location: — [E/AndreidCode/HelloAndrcid = dar eas PME n > 
Working sets E Google APis Google Inc. 21 7 
El Add project to working sets E Android22 Android Open Source Project 2.2 8 
Working sets: [ Fi Google APIs Google Inc. 22 8 
F1 DTS Add-On KYOCERA Corporation 22 8 
目 ResBD Add-On LGE 22 8 
E GALAXY Tab Ad.. Samsung Electronics Co, Ltd. — 22 8 
国 Android 23.3 Android Open Source Projet 23.3 10 
加 Google APIs Google Inc. 233 10 
ei ot 222 pe 
Standard Android platform 2.3.3 


® "| 


图 1-32 为 应 用 项 目 命名 图 1-33 选择 新 建 项 目的 SDK 版 本 页 
输入 完 这 个 信息 后 , 单 击 Finish 按钮 ,一 个 Android 项 目 就 创建 完成 了 。 展 开 这 个 项 目 ， 
如 图 1-35 所 示 。 


Application Info 
Configure the new Android Project 
[4 GÀ HelloAndroid — 


Application Name: Hello Android Bsr 

4 i cncomsgmsc.Hello 
Package Name: — cn.com.sgmsc.Hello. > B) Hellojava 
W Create Activity: Hello 


gen [Generated Java Files] 
4 8i cncom.sgmsc.Hello 


Minimum SDK: — 10 + > B) BuildConfigjava 
» D Rja 

[E] Create a Test Project. b mÀ Android 2.3.3 

Test Project Nare: | HelloAndroidTest. b ^ Android Dependencies 

Ter Applicaton rr R ka. 

Test Package: cn.com.sgmsc.Hello.test. 4 D» res 


[o] IET 


v (CER em] 


图 1-34 新 建 应 用 项 目的 信息 页 


© drawable-hdpi 
> © drawable-ldpi 
> © drawable-mdpi 
> © drawable-xhdpi 
4 © layout 

E mainxml 
4 © values 

B strings.xml. 
回 AndroidManifestaml 
B proguard-projecttxt. 
B projectproperties 


1-35 HelloAndroid 项 目 目录 
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1.4.2 运行 Android 的 第 一 个 应 用 


启动 模拟 器 ,在 Eclipse 的 Package Explore 中 选择 项 目 名 HelloAndroid, 然 后 单间 


E RER 


右键 ,在 弹出 的 菜单 中 选择 Run As- Android Application , 即 可 在 模拟 器 中 运行 该 项 目 了 。 


其 显示 结果 如 图 1-36 所 示 。 


E) 5554:And-23 


Hello, Android 


er 
mmmmmmmrmmrs 
Fo 
lr inel mad le 


Fd 1-36 运行 HelloAndroid 项 目的 效果 


如 果 想 横向 显示 运行 结果 ,可 以 在 PC 的 键盘 上 使 用 Ctrl 十 Fl11 组 合 键 ,改变 模拟 器 显示 


方向 ,如 图 1-37 所 示 。 


E3 5554And-23 
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图 1-37 横向 显示 HelloAndroid 项 目的 运行 结果 
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小 结 


本 章 是 学 习 Android 应 用 开发 的 起 步 ,以 概述 的 形式 介绍 了 Android 平台 的 诞生 背景 ,发 
展 历程 应 用 前 景 ,介绍 了 Android 平台 的 框架 结构 :了 解 这 些 知识 有 助 于 读者 明白 学 习 
Android 应 用 开发 的 目的 。 在 本 章 的 后 两 节 中 详细 地 介绍 了 Android 开发 环境 的 搭建 ， 
Android 项 目的 创建 与 运行 。 相 信 读 者 在 学 习 了 本 章 之 后 ,已 经 完全 地 掌握 了 在 Eclipse 环境 
下 开发 Android 应 用 项 目的 步骤 。 

不 可 避免 地 ,有 些 读 者 会 问 : 为 什么 HelloAndroid 应 用 项 目 没有 进行 任何 编程 就 可 以 运 
行 出 结果 ? 如 果 想 知道 ,请 学 习 第 2 章 。 


练习 


1. 独立 完成 Android 的 环境 搭建 。 
2. 创建 并 运行 一 个 HelloAndroid 应 用 项 目 。 


Android 应 用 程序 的 构成 


第 1 章 中 已 经 介绍 了 创建 HelloAndroid 应 用 程序 的 全 过 程 。 在 创建 过 程 中 ,没有 经 过 任 
何 代码 编程 ,只 是 在 创建 向 导 中 设置 了 几 个 名 称 和 选择 了 一 些 选项 ,就 可 以 运行 了 。 在 
Android 中 创建 一 个 项 目 就 是 这 么 简单 ,但 是 要 根据 实际 应 用 开发 某 个 项 目 , 还 有 许多 功课 
要 做 。 

现在 ,几乎 每 一 个 平台 都 会 有 自己 的 结构 框架 ,例如 在 最 初学 习 Java 或 者 C\C++ 时 ,第 一 
个 程序 总 是 main 函数 ,以 及 文件 类 型 和 存储 方式 等 。 本 章 将 对 Android 平台 的 目录 结构 、 文 
件 类 型 及 其 各 自负 责 的 功能 进行 剖析。 


&.1 Android 应 用 程序 目录 结构 


第 1 章 中 建立 的 HelloAndroid 应 用 项 目 , 其 代码 是 由 ADT 插件 自动 生成 的 ,形成 Android 
项 目 特有 的 结构 框架 。 在 Eclipse 中 ,展开 Package Explorer 导航 器 中 的 HelloAndroid 项 目 ， 
可 看 到 其 目录 结构 ,如 图 2-1 所 示 。 
看 到 这 个 项 目 目录 ,可 能 会 有 似曾相识 的 感觉 。 其实 Android | 
应 用 程序 就 是 由 Java 代码 和 XML 属性 声明 共同 设计 完成 ,在 编写 | nec 
代码 时 要 注意 ,Java 代码 和 XML 代码 都 是 大 小 写 敏感 的 。 每 个 aaepe 


4 (B9 gen [Generated Java Files] 


Android 应 用 项 目 都 以 一 个 项 目 目录 的 形式 来 组 织 。 下 面 对 其 目 4 E oncomsgmscHelo 


录 结 构 进 行 详细 的 介绍 。 , a Msn 
b BÀ Android 2.3.3 
» mà Android Dependencies 
TERR B assets 
» © bin 


src 目录 存放 Android 应 用 程序 中 的 所 有 Java 源 代 码 , 并 且 以 “Bres 


> © drawable-hdpi 


用 户 所 声明 的 包 进 行 自 动 地 组 织 。 例 如 在 创建 HelloAndroid 项 目 deii 
时 ,定义 的 包 为 “cn. com. sgmsc. Hello". JI 4 Hello. java 文件 就 在 » (B drawable-xhdpi 
这 个 包 内 ,其 目录 组 织 方式 为 src/ cn/com/sgmsc/ Hello/ Hello. java. gm 
程序 员 在 项 目 开发 过 程 中 ,大 部 分 时 间 是 对 该 目录 下 的 源 代码 文件 | I Iun 


进行 编写 。 如 果 是 复杂 一 点 的 应 用 ,该 目录 下 会 有 多 个 源 代码 | ocsetesc 
文件 。 [B projectproperties 


2. gen 目录 
图 2-1 HelloAndroid 项 目 


gen 目录 下 的 文件 是 由 ADT. 自动 生成 的 ,不 需要 人 为 去 修改 。 的 目录 
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该 目录 下 只 有 一 个 定义 在 包 内 的 R.java 文件 。R. java 对 于 Android 系统 非常 有 用 ,这 个 文件 
中 为 Android 项 目 中 的 各 个 资源 在 相应 的 类 中 创建 其 唯一 的 ID, 当 项 目 使 用 到 这 些 资源 时 ， 
会 通过 该 类 得 到 资源 的 引用 。 如 果 项 目 资源 发 生 了 变化 ,R. java 都 会 重新 编译 ,同步 更 新 。 


3. Android2.3.3 目录 
Android2. 3. 3 目录 存放 该 项 目 支持 的 jar 包 。 
4. assets 目录 


assets 目录 存放 项 目 中 用 到 的 相关 资源 文件 ,如 文本 文件 .视频 文件 .MP3 等 媒体 文件 。 
在 程序 中 可 以 使 用 “getResources. getAssetsO. open("< 文 件 名 >")” 方 法 得 到 资源 文件 的 输入 
流 InputStream 对 象 。 


5. res 目录 


res 目录 存放 整个 项 目 经 常 使 用 的 资源 文件 ,该 目录 称 为 资源 目录 ,包括 一 些 图 标 ,声音 、 
布局 文件 及 参数 撒 述 文件 等 。 当 新 建 一 个 项 目 时 ,系统 在 该 目录 中 自动 建立 以 下 目录 。 

(1) 以 drawable 开头 的 4 个 目录 : drawable-ldpi、drawable-mdpi、drawable-hdpi 和 
drawable-xhdpi 目录 ,分 别 存储 低 .中 ,高 和 超 高 分 辩 率 的 图 片 文件 。dpi 是 dot per inch 的 缩 
写 ,表示 每 英寸 像 素数 。 可 使 用 的 图 片 文件 类 型 如 . png.. 9. png、 jpg 等 图 片 资 源 。 程 序 运 行 
时 可 以 根据 手机 分 辩 率 的 高 低 分 别 选 取 相应 目录 下 的 图 片 文件 。 如 果 不 想 准备 太 多 分 辩 率 的 
图 片 , 也 可 以 只 准备 一 组 图 片 存 放 于 这 4 个 目录 的 任何 一 个 中 。 

(2) layout 目录 : 存放 应 用 程序 的 布局 文件 ,文件 类 型 为 XML 格式 。 新 建 项 目 时 ADT 
都 会 自动 创建 一 个 main. xml 文件 。 与 在 网 页 布局 中 使 用 HTML 文件 一 样 ,Android f£ XML 
文件 中 使 用 XML 元 素来 设 定 屏幕 的 布局 。 在 layout 目录 中 的 每 个 XML 文件 包含 整个 屏幕 
或 部 分 屏幕 的 视图 资源 。 

(3) values 目录 : 存放 所 有 XML 格式 的 资源 描述 文件 ,例如 字符 串 (strings. xml) \ 颜 色 
(colors. xml) ,样式 (styles. xml) , 尺寸 (dimens. xml) 和 数组 (arrays. xml) 等 描述 文件 。 

需要 注意 的 是 : res 目录 中 的 所 有 文件 名 只 能 是 以 “a”~“z”“0”~“9” 或 “ ”字符 命名 ,不 
能 包含 大 写字 母 , 否 则 会 导致 错误 。 

在 Java 代码 中 ,可 以 使 用 getResources(). getDrawable(resourceld) 方 法 来 获取 一 个 图 片 ; 可 
以 使 用 getResources(). getString(resourceld) 或 getResources(). getText (resourceld) 方 法 来 获取 
strings. xml 中 的 一 个 字符 串 ; 可 以 使 用 getResourcesO. get StringArray(resourceld) 方 法 获取 一 
个 String 数组 ; 可 以 使 用 getResources(). getColor(resourceld) 方 法 来 获取 一 种 颜色 等 。 

问 一 下 : 

为 什么 要 有 资源 描述 文件 ? 

有 两 个 好 处 。 以 字符 囊 描述 文件 strings. xml 为 例 。 一 是 可 以 方便 地 实现 双语 显示 , 例 
如 中 文 和 英文 。 可 以 将 应 用 程序 中 要 显示 的 文字 以 两 种 语言 的 形式 都 存放 在 strings. xml 文 
件 中 ,然后 在 程序 中 设置 ,如 果 手 机 在 中 国 地 区 使 用 ,就 显示 中 文 ,如 果 手 机 在 英文 国度 使 用 ， 
就 显示 英文 。 二 是 方便 程序 的 维护 。 如 果菜 些 文字 在 程序 中 的 多 处 出 现 ,可 以 将 它 写 入 
strings. xml 文件 中 ,而 在 程序 中 只 是 引用 它 的 ID, 这 时 ,如 果 要 修改 其 文字 内 容 , 只 需要 在 
strings. xml 中 修改 其 字符 串 内 容 , 而 不 必修 改 源 代码 。 
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6. AndroidManifest. xml 文件 


AndroidManifest. xml 文件 是 项 目的 系统 控制 文件 ,或 称 为 功能 清单 文件 。 每 个 Android 
项 目 必须 有 这 个 文件 ,位 于 项 目的 根 目录 下 。 这 个 清单 文件 给 Android 系统 提供 关于 这 个 应 
用 程序 的 基本 信息 ,系统 在 运行 任何 程序 代码 之 前 必须 知道 这 些 信息 。 其 详细 内 容 将 在 2. 4 
节 中 进行 介绍 。 


7. proguard-project. txt 文件 


proguard-project. txt 文件 是 混淆 代码 的 脚本 配置 文件 。 当 创建 一 个 Android 项 目的 时 
候 , 在 项 目的 根 目录 下 会 自动 生成 proguard-project. txt 文件 。 这 个 文件 定义 了 proguard 如 
何 优化 和 混乱 项 目 代码 ,以 得 到 一 个 体积 更 小 的 并 且 更 难以 使 用 北向 项 目 ( 反 编译 ) 的 apk XC 
件 , 达 到 一 定 的 加 密 效果 。 例 如 需要 对 应 用 添加 许可 的 时 候 , 可 以 使 用 Proguard 工具 ,使 应 用 
难以 使 用 逆向 项 目 。 

在 Android 2. 3 版 本 以 后 ,Google 才 开始 封装 代码 混淆 的 脚本 文件 。Proguard 已 经 集成 
在 Android 编译 系统 之 中 ,所 以 不 必 手 动 去 调用 它 。Proguard 只 在 以 release 模式 编译 的 时 候 
才 会 运行 ,所 以 当 使 用 debug 模式 编译 的 时 候 不 必 与 混乱 后 的 代码 打交道 。 


8. project. properties 文件 


project. properties 文件 是 当前 应 用 所 使 用 Android 的 配置 信息 。 


@.3 Android 应 用 程序 解析 


Android 应 用 程序 主要 由 三 部 分 组 成 : 应 用 程序 描述 文件 . xml, 各 种 资源 ,以 及 应 用 程序 
源 代码 . java。 可 以 这 样 理解 : 一 个 Android 应 用 程序 ,程序 员 需 要 做 的 事 是 由 Java 代码 实现 
其 业务 逻辑 ,由 XML 文件 来 描述 其 界面 及 其 他 一 切 资源 。 

其 实 ,Android 应 用 的 界面 设计 也 可 以 使 用 Java 代码 来 完成 ,在 实际 编程 中 有 时 候 少数 
界面 组 件 也 是 通过 代码 实现 的 ,这 样 做 比较 快捷 ,但 是 会 增加 代码 的 长 度 , 且 不 便 维护 。 更 多 
地 ,界面 的 设计 是 通过 XML 文件 来 描述 。 这 样 做 的 好 处 在 于 : 界面 设计 与 程序 逻辑 相 分 离 ， 
使 得 代码 更 加 短小 易 维护 ,更 加 符合 MVC 设计 原则 。 

问 一 下 : 

什么 是 MVC 设计? 

MVC 是 当前 流行 的 设计 模式 框架 , 它 强制 性 地 将 应 用 程序 的 输入 、 处 理 和 输出 分 开 。 使 
用 MVC 应 用 程序 被 分 成 三 个 核心 部 件 : M 即 数据 模型 ,V 即 用 户 界 面 ,C 即 控制 器 ,它们 各 
自 处 理 各 自 的 任务 。 使 用 MVC 的 目的 是 将 M 和 V 的 代码 分 离 , 从 而 使 同一 个 程序 可 以 使 用 
不 同 的 表现 形式 。 例 如 一 批 统计 数据 可 以 分 别 用 柱状 图 、 饼 图 来 表示 。C 存在 的 目的 则 是 确 
保 M 和 VV 的 同步 ,一 旦 M 改变 ,V 应 该 同步 更 新 。 

MVC 设计 模式 的 优点 在 于 它 的 低 耦 合 性 、 高 重用 性 和 可 适用 性 。 并 且 让 代码 程序 员 集 
中 精力 于 业务 训 辑 开发 ,让 界面 程序 员 集 中 精力 于 表现 形式 上 设计 ,这 样 大 大 地 降低 了 开发 和 
维护 的 技术 成 本 ,缩减 开发 时 间 ,使 得 应 用 程序 得 以 快速 的 部 署 。 但 是 由 于 MVC 没有 明确 的 
定义 ,要 完全 理解 MVC 并 不 是 很 容易 ,在 实际 开发 中 需要 花费 一 些 时 间 去 精心 计划 MVC 框 
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架 。 尽 管 构 造 MVC 应 用 程序 需要 一 些 额外 的 工作 量 , 但 是 它 带 来 的 好 处 是 毋庸 置疑 的 。 
Android 应 用 程序 设计 大 多 是 采用 MVC 框架 。 
下 面 通过 HelloAndroid 项 目的 解析 来 理解 Android 应 用 程序 。 


2.2.1 资源 及 其 描述 文件 


可 以 从 图 2-1 中 看 到 ,新 建 一 个 Android 项 目 , 会 在 res 下 的 drawable-hdpi、 drawable- 
Idpi,drawable-mdpi 和 drawable-xhdpi 目录 中 分 别 存放 一 个 默认 的 图 标 icon. png 文件 ,虽然 
文件 名 一 样 ,但 它们 的 分 辨 率 不 一 样 ,显示 大 小 不 一 样 。 如 果 在 项 目 中 还 需 用 到 其 他 的 图 片 文 
件 ,可 以 将 那些 图 片 文件 拷贝 到 上 述 四 个 目录 中 之 一 。HelloAndroid 项 目 使 用 项 目 创建 时 的 
默认 图 标 文件 。 


1. 资源 描述 文件 


新 建 一 个 Android 项 目 都 会 自动 创建 一 个 定义 字符 串 常 量 的 描述 文件 strings. xml, 它 存 
放 于 res/values 目录 中 。 

打开 HelloAndroid 项 目 目录 下 res/values 中 的 strings. xml 文件 ,其 代码 如 下 。 

1 <?xml version= "1.0" encoding = "utf - 8"?» 

2 «resources? 

3 < string name = "hello" Hello World, Hello!«/string» 

4 < string name = "app name"» Hello, Android </string> 

5 «resources? 

COD 第 1 行 声明 了 XML 的 版 本 以 及 编码 方式 。 

(2) < resources > 是 定义 资源 的 标签 。 

(3) 第 2 一 5 行 定义 两 个 字符 串 常量 ,字符 串 的 名 字 分 别 为 hello 和 app_name, 其 内 容 分 
别 是 “Hello World，Hello!” 和 “Hello,.Android”。 定 义 之 后 该 项 目 允 许 在 Java 代码 和 XML 
代码 中 使 用 这 些 资源 文件 中 的 字符 串 资 源 。 

HelloAndroid 项 目 只 有 strings. xml 资源 描述 文件 。 有 些 应 用 项 目 还 会 有 colors. xml, 
dimens. xml, styles. xml 等 资源 描述 文件 。 

1) colors. xml 文件 

colors. xml 文件 创建 布局 的 颜色 常量 ,使 用 "< color >” 标 签 定义 一 个 颜色 资源 。 颜 色 值 由 
RGB( 三 位 十 六 进 制 数 ) 或 RRGGBB(6 位 十 六 进 制 数 ) 表 示 , 以 “#” 符 号 开头 。 例 如 : #00f 
( 蓝 色 )，#00ff00( 绿 色 )。 定 义 透明 色 , 表 示 透 明度 的 alpha 通道 值 紧 随 “#” 之 后 。 例 如 : 
#600f( 透 明 蓝 色 )，#7700ff00( 透 明 绿色 )。 

2) dimens. xml 文件 

dimens. xml 文件 通常 用 于 创建 布局 常量 ,在 样式 和 布局 资源 中 定义 边界 、 高 度 和 尺寸 大 
小 等 。 使 用 "< dimen >” 标 签 指定 一 个 维度 资源 。 

常用 的 维度 定义 单位 如 下 。 

COD px( 像 素 ): 屏幕 上 的 像素 。 

(2) in( 英 寸 ) : 长 度 单位 。 

(3) mm( 毫 米 ) : 长 度 单位 。 

(D pt( 磅 ): 1/72 英寸 。 


29 


V 


NT Android 应 用 开发 教程 


(5) dip( 与 密度 无 关 的 像素 ) : 一 种 基于 屏幕 密度 的 抽象 单位 。 在 每 英寸 160 点 的 显示 器 
上 ,1dip 二 1px。 但 随 着 屏幕 密度 的 改变 ,dip 与 px 的 换算 会 发 生 改 变 。 

(6) sp 〈 与 刻度 无 关 的 比例 像素 ) : 与 dip 类 似 , 主 要 处 理 字体 的 大 小 ,可 以 根据 用 户 的 字 
体 大 小 首选 项 进行 缩放 。 

建议 : 使 用 sp 作为 文字 的 单位 ,使 用 dip 作为 其 他 元 素 的 单位 。 

3) styles. xml 文件 

styles. xml 文件 用 于 预先 定义 布局 中 需要 显示 的 样式 ,如 文本 的 显示 颜色 和 字体 等 。 
例如 : 


1 <?xml version = "1.0" encoding = "utf - 8"?» 

2 <resources> 

3 < style name = "BaseText"> 

4 < item name = "android:textSize"> 14sp </item> 

5 < item name = "android:textColor">#111 </item> 
6 </style> 

yi < style name = "SmallText" parent = "BaseText"» 

8 < item name = "android:textSize"» 8sp«/item» 

9 «/style» 

10 </resources > 


CD 第 3 一 6 行 定义 “BaseText? 样 式 ,该 样式 文本 的 大 小 为 14sp ,颜色 为 #111。 


(2) 第 7 一 9 行 定义 “SmallText” 样 式 , 它 是 BaseText 的 子 样式 。 在 保持 其 父 样式 的 其 他 
属性 不 变 的 情况 下 ,定义 文本 大 小 为 8sp。 


2. 界面 布局 文件 


新 建 的 项 目 会 自动 创建 一 个 main. xml 文件 , 它 定义 第 一 个 屏幕 界面 。 一 般 地 ,应 用 程序 
需要 定义 多 个 屏幕 界面 ,程序 员 根 据 应 用 需求 ,在 该 目录 下 进行 手动 创建 。 

打开 HelloAndroid 项 目 目录 下 res/layout 中 的 main. xml 文件 ,其 代码 如 下 。 

1 <?xml version = "1.0" encoding = "utf - 8"?» 


2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height - "fill parent" 
6 > 

7 <TextView 

8 android:layout width- "fill parent" 

9 android:layout height = "wrap content" 
10 android:text = "(üstring/hello" 

11 /> 


12 </LinearLayout > 


CD 第 1 行 声 明了 XML 的 版 本 以 及 编码 方式 。 

(2) 第 2 一 12 行 向 屏幕 界面 添加 一 个 垂直 的 线性 布局 。 

(3) 第 2 行 标签 中 的 属性 “xmlns: android =" http://schemas. android. com/apk/res/ 
android" "是 XML 命名 空间 的 声明 , 它 告 诉 Android 的 工具 , 你 将 要 涉及 公共 的 属性 已 被 定 
义 在 XML 命名 空间 。 在 每 一 个 Android 的 布局 文件 的 最 外 层 标 签 必 须 有 这 个 属性 。 

(4) 第 7 一 11 行 向 线性 布局 中 添加 一 个 文本 控件 TextView, 显 示 的 内 容 为 strings. xml 
文件 中 常量 “Hello" 定 义 的 字符 串 内 容 。 
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3. R. java 文件 


gen 目录 下 cn. com. sgmsc. Hello 包 中 的 R. java 文件 为 Android 项 目 中 的 各 个 资源 创建 
了 唯一 的 ID。 打开 R. java 文件 ,其 代码 如 下 。 
1 package cn. com. sgnsc. Hello; 


2 
3 public final class R { 


4 public static final class attr { 

5 } 

6 public static final class drawable { 

7 public static final int icon = 0x7f020000; 
8 } 

9 public static final class layout { 

10 public static final int main = 0x7f030000; 
11 } 

12 public static final class string { 

13 public static final int app_name = 0x7f040001; 
14 public static final int hello = 0x7f040000; 
15 } 

16 } 


COD 58 1 行 是 声明 R.java 在 该 包 下 。 

(2) 第 3 一 16 行 定义 R 类 。 

(3) 第 6 一 8 行为 项 目 中 使 用 的 图 片 资 源 创建 ID。 

(4) 第 9 一 11 行为 项 目 中 使 用 的 屏幕 布局 创建 ID 。 

(5) 第 12 一 15 行为 项 目 中 使 用 的 字符 串 常 量 创建 ID 。 

就 这 样 ,R. java 把 项 目 中 需要 使 用 的 资源 ,用 ID 的 形式 标注 了 drawable, layout, values 
三 个 目录 中 的 资源 信息 ,其 中 values 目录 只 有 字符 串 资源 文件 strings. xml。 


4. 功能 清单 文件 


每 个 Android 项 目 都 必须 有 一 个 清单 文件 .用 于 应 用 程序 的 全 局 描述 。 当 新 建 一 个 项 目 
时 ,ADT 自动 创建 一 个 AndroidManifest. xml 文件 ,存放 在 项 目的 根 目录 下 。 
打开 HelloAndroid 项 目 根 目 录 下 的 AndroidManifest. xml 文件 ,其 代码 如 下 。 


1 <?xml version = "1.0" encoding = "utf - 8"?» 

2 «manifest xmlns:android = "http://schemas. android. com/apk/res/android" 

package = "cn. com. sgnsc. Hello" 

4 android:versionCode - "1" 

$ android: versionName = "1. 0"> 

6 < application android: icon = "@drawable/icon" android: label = "@string/app_name"> 
Li 

8 


w 


«activity android:name = ". Hello" 
android: label = "@string/app_name"> 


9 < intent - filter» 

10 X action android:name = "android. intent. action. MAIN" /> 

it < category android:name = "android. intent. category. LAUNCHER" /> 
12 «/ intent - filter» 

13 «/activity» 

14 «/application? 

15 « uses - sdk android:minSdkVersion = "10" /> 


16 </manifest > 
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CD 第 工行 声明 了 XML 的 版 本 以 及 编码 方式 。 

(2) 第 2 一 16 行 声 明 该 应 用 程序 所 包含 的 包 名 组件, 资源 .可 兼容 的 最 低 版 本 等 信息 。 

(3) 第 2 行 标签 中 的 属性 “xmlns: android =" http://schemas. android. com/apk/res/ 
android" "是 XML 命名 空间 的 声明 。 在 每 一 个 Android 的 清单 文件 的 最 外 层 标签 必须 有 这 个 


属性 。 


(4) 第 3 行 声明 应 用 程序 的 包 名 。 

(5) 第 6 行 声明 应 用 程序 的 图 标 和 标签 名 称 , 图 标 使 用 res/drawable 目录 下 的 icon. png 
文件 ,标签 名 称 使 用 res/values 目录 下 的 strings. xml 中 常量 “app name” 定 义 的 字符 串 内 容 。 

(6) 第 7 行 声明 应 用 程序 第 一 个 运行 的 Java 代码 是 src 下 包 中 的 Hello. java 文件 。 

C 第 8 行 声明 屏幕 上 的 标题 显示 内 容 是 strings. xml 中 常量 “app name” 定 义 的 字符 串 。 

(8) 第 15 行 声明 应 用 程序 可 兼容 的 最 低 版 本 号 为 10。 

AndroidManifest. xml 文件 中 的 这 些 声明 大 多 都 是 在 创建 HelloAndroid 项 目 时 定义 的 ， 
如 图 2-2 所 示 。 


2. 


1] New Android Project => a/g) 


Application Info 
Configure the new Android Project 


Application Name: Hello Android 


Package Name: — cncom.sgmsc-Hello 


Create Activity: Hello - 


Minimum SOK: — 10 - 


图 2-2 创建 HelloAndroid 项 目的 定义 项 


2.2 逻辑 代码 文件 


应 用 程序 的 操作 控制 部 分 在 Java 源 程序 中 定义 。 创 建 HelloAndroid 项 目 时 ,在 图 2-2 的 
Create Activity 框 中 输入 的 “Hello”, 就 是 定义 该 项 目的 逻辑 代码 文件 名 为 “Hello. java" o 

Hello. java 位 于 项 目的 src 目录 中 。 打 开 HelloAndroid 项 目下 src/cn. com. sgmsc. Hello 
中 的 Hello. java 文件 ,其 代码 如 下 。 


1 
2 
3 
4 
5 
6 
了 
8 


9 

10 
1 
12 
13 
14 


package cn. com. sgmsc. Hello; 


import android. app. Activity; 
import android. os. Bundle; 


public class Hello extends Activity { 

// 当 第 一 次 创建 该 Activity 时 回调 该 方法 

@Override 

public void onCreate(Bundle savedInstanceState) { 
// 调 用 父 类 的 onCreate 构造 函数 , savedInstanceState 是 保存 当前 Activity 的 状态 信息 
super. onCreate(savedInstanceState); 
setContentView(R. layout. main); // 设 置 当 前 显示 的 布局 

} 
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CD 第 1 行 是 声明 Hello. java 在 该 包 下 。 

(2) 第 3 一 4 行 是 引入 相关 的 类 。 

(3) 第 6 行 是 定义 Hello 类 的 开始 , 它 表示 Hello 是 一 个 公开 的 继承 自 Activity 的 类 ,而 
这 个 Activity 就 是 第 3 行 引 入 的 类 。 其 全 部 代码 写 在 一 对 “{}” 大 括号 内 。 注 意 ,在 Java 代码 
中 每 个 类 名 都 必须 与 其 相应 的 代码 文件 名 一 致 。 

(4) 第 6 一 14 行 定义 Hello 类 。 

(5) 第 8 ITHO Override 表示 要 重 写 紧 跟 在 它 下 面 的 方法 。 它 下 面 的 是 onCreate() 方 
法 ,此 时 是 重 写 onCreate() 方 法 。 因 为 Hello 类 是 继承 自 android. app. Activity 类 的 ,原来 的 
Activity 类 有 定义 onCreate() 方 法 , 重 写 onCreate() 方 法 就 是 重新 定义 Hello 类 自己 的 
onCreate() 方 法 。 当 应 用 程序 执行 时 ,就 会 执行 Hello 类 自己 的 onCreate( ) 方 法 里 的 代码 。 

(6) 第 9 一 13 行 重新 定义 了 onCreate() 方 法 ,其 中 onCreate() 方 法 传人 了 一 个 名 为 
savedInstanceState 的 Bundle 类 型 参数 。 

(7) 第 11 行 是 调用 Hello 类 的 父 类 即 Activity 类 的 onCreate() 方 法 。 几 乎 每 一 个 
Android 代码 程序 在 重 写 onCreate() 方 法 时 ,都 会 先 调用 其 父 类 的 onCreate() 构 造 方 法 。 
Bundle 类 型 参数 savedInstanceState 用 于 保存 当前 Activity 的 状态 信息 。 

(8) 第 12 行 设置 当前 显示 的 布局 , 即 显示 res/layout/main. xml 文件 中 定义 的 屏幕 布局 。 

回顾 一 下 , strings. xml 文件 定义 了 字符 串 F? 5554:And-23 
常量 , main. xml 文件 定义 了 显示 文本 ， 
AndroidManifest. xml 声明 了 应 用 项 目的 显示 nu ccs 
图 标 和 名 字 、 屏 幕 标 题 显 示 的 文本 ,并 指出 代码 ”文本 
文件 是 cn. com. sgmsc. Hello 包 中 的 Hello. java 
文件 , Hello. java 文件 指定 屏幕 按 res/layout/ 
main, xml 文件 中 定义 的 布局 显示 。 因 此 ， 图 2-3 HelloAndroid 运行 的 结果 
HelloAndroid 项 目 运行 的 结果 如 图 2-3 所 示 。 


2.3 Android 的 基本 组 件 


Android 是 一 个 为 组 件 化 而 搭建 的 平台 , 它 的 应 用 程序 由 一 些 零散 的 有 联系 的 组 件 组 成 ， 
并 通过 工程 的 AndroidManifest. xml 把 它们 绑 定 在 一 起 。 

Android 应 用 程序 常用 的 组 件 有 Activity (活动 )、Service( 服 务 )、Broadcast Receiver( 广 
播 接收 器 ) ,Intent( 意 图 ) .Content Provider( 内 容 提供 器 ) 和 Notification( 通 知 ) 等 。 然 而 ,并 
不 是 所 有 的 应 用 程序 都 必须 包含 这 些 组 件 , 但 一 般 是 由 上 面 的 一 个 或 多 个 组 件 来 组 建 。 当 你 
决定 使 用 以 上 哪些 组 件 来 构建 Android 应 用 程序 时 ,就 应 该 将 它们 列 在 AndroidManifest. 
xml 文件 中 ,并 且 声明 它们 的 特性 和 要 求 。 


1. Activity 


Activity 是 Android 中 最 常用 的 组 件 ,一 个 Activity 展现 一 个 可 视 化 的 用 户 界 面 , 它 是 应 

用 程序 的 显示 层 。 例 如 ,一 个 Activity 可 能 展现 为 一 个 用 户 可 以 选择 的 菜单 项 列表 ,或 者 展现 

- 些 图 片 以 及 图 片 的 标题 。 通 常 一 个 应 用 程序 会 有 多 个 Activity。 虽 然 这 些 Activity 一 起 工 
TE ,但 每 一 个 Activity 都 是 相对 独立 的 。 每 个 Activity 都 继承 自 android. app. Activity 类 。 
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Activity 显示 的 每 一 个 内 容 都 是 由 View( 视 图 ) 对 象 去 构建 ,并 定义 在 res/layout 下 的 
XML 文件 中 。Android 自 带 了 很 多 View 对 象 .例如 按钮 ,文本 框 \ 滚 动 条 、 菜 单 . 多 选 框 等 。 
每 个 视图 或 视图 组 对 象 在 布局 文件 中 都 有 它们 自己 的 XML 属性 ,其 中 的 ID 属性 唯一 来 标识 
这 个 视图 对 象 , 这 个 ID 属性 有 时 被 定义 为 字符 串 ,编译 后 为 整 型 数值 。 

如 果 在 HelloAndroid 的 main. xml 中 的 TextView 对 象 增加 一 个 ID 属性 如 下 , 见 下 列 代 
码 的 第 8 行 。 


1 <?xml version = "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


11 
12 


4 
5 
6 
7 «TextView 
8 
9 


android:orientation = "vertical" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
> 


android: id= "(9 + id/tvStr" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:text = "@string/hello" 

/> 


13 </LinearLayout > 


再 打开 R. java, 可 看 到 增加 了 一 个 ID, 见 下 列 代码 的 第 9—11 fT. 


package Hello. cn. com. seles. www; 


public final class R ( 


public static final class attr ( 
) 
public static final class drawable ( 
public static final int icon = 0x7f020000; 
) 
public static final class id ( 
public static final int tvStr = 0x7£050000; 
) 
public static final class layout ( 
public static final int main = 0x7f030000; 
) 
public static final class string ( 
public static final int app name - 0x7f040001; 
public static final int hello = 0x7f040000; 


问 一 下 : 

“@ 十 id” 与 “@id” 的 区 别 ? 

我 们 经 常 在 布局 文件 中 看 到 View 对 象 的 ID 属性 声明 ,有 时 候 用 “@ 十 id”, 有 时 候 用 
“Q@id”.“@ 十 id” 表示 在 及 文件 中 产生 一 个 新 的 ID, 如 果 没有 “十 ”, 而 是 “@id”, 就 是 引用 其 
他 地 方 已 经 定义 过 的 ID. 45] de" android id — "(9 +id/tvStr"”. iX €," (9" #5 E EIE AS View 
对 象 的 ID 自动 记载 在 及 文件 中 必 十 ”号 表示 向 及 文件 中 的 内 部 类 ID 中 添加 一 个 变量 ,名 字 


»| tvStr, 


启动 一 个 Activity 有 三 种 方法 。 一 般 在 onCreate() 方 法 内 调用 setContentViewO Jr ik. 
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用 来 指定 将 要 启动 的 res/layout 目录 下 的 布局 文件 ,例如 setContentView(R. layout. main)。 
第 二 种 方法 是 调用 startActivity(), 用 于 启动 一 个 新 的 Activity。 第 三 种 方法 是 调用 
startActivityforResult O ,用 于 启动 一 个 Activity, 并 在 该 Activity 结束 时 会 返回 信息 。 

在 HelloAndroid 应 用 程序 中 ,使 用 的 就 是 setContentView() 方 法 来 启动 这 个 Activity 
的 。 其 Hello. java 代码 如 下 。 


package cn. com. sgmsc. Hello; 


import android. app. Activity; 
import android. os. Bundle; 


public class Hello extends Activity { 

// 当 第 一 次 创建 该 Activity 时 回调 该 方法 

(QOverride //3& 5j onCreate( ) 方 法 
9 public void onCreate(Bundle savedInstanceState) { 
10 super. onCreate(savedInstanceState); 
11 setContentView(R. layout. main); // 设 置 当 前 显示 的 布局 
12 } 


返回 一 个 Activity 也 有 三 种 方法 。 通 常 调用 finish ) 方 法 来 关闭 一 个 Activity。 如 果 调 
用 setResult() 方 法 , 则 可 以 返回 数据 给 上 一 级 的 Activity。 当 使 用 startActivityforResult() 
启动 的 Activity 时 , 则 需要 调用 finishActivity() 方 法 ,来 关闭 其 父 Activity, 


2. Service 


Service 没有 用 户 界面 ,但 它 会 在 后 台 一 直 运 行 。 例 如 ,Service 可 能 在 用 户 处 理 其 他 事情 
MERIT BETER RA AA E UAN, 或 者 执行 一 些 运算 ,并 把 运算 结果 提供 给 
Activity 展示 给 用 户 。 每 个 Service 都 继承 自 Serivce 类 。 

Service 一 般 由 Activity 启动 ,但 是 并 不 依赖 于 Activity, Service 具有 和 较 长 的 生命 周期 ， 
即使 启动 它 的 Activity 的 生命 周期 结束 了 ,Service 仍然 会 继续 运行 ,直到 自己 的 生命 周期 结 
SOWIE. 

Service 的 启动 方式 有 两 种 ,startService 方式 和 bindService 方式 。 

(1) 使 用 startService 方式 启动 。 当 在 Activity 中 调用 startService() 方 法 启动 Service 
上 时 ,会 依次 调用 onCreate() 和 onStart() 方 法 ; 调用 stopService() 方 法 结束 Service 时 ,会 调用 
onDestroy() 方 法 。 

(2) 使 用 bindService 方式 启动 。 调 用 bindService() 方 法 启动 Service 时 ,会 依次 调用 
onCreate() 和 onBind() 方 法 ; 调用 unbindService() 方 法 结束 Service 时 ,会 调用 onUnbind() 
和 onDestroy() 方 法 。 


3. Broadcast Receiver 


Broadcase Receiver 不 执行 任何 任务 , 仅 是 接受 并 响应 广播 通知 的 一 类 组 件 。 大 部 分 广播 
通知 是 由 系统 产生 的 ,例如 改变 时 区 ,电池 电量 低 , 用 户 选择 了 一 幅 图 片 或 者 用 户 改变 了 语言 
首选 项 。 应 用 程序 同样 也 可 以 发 送 广 播 通知 ,例如 通知 其 他 应 用 程序 某 些 数 据 已 经 被 下 载 到 
设备 上 可 以 使 用 。 一 个 应 用 程序 可 以 包含 任意 数量 的 Boradcase Reveiver 来 响应 它 认 为 很 重 
要 的 通知 。 每 个 Broadcast Receiver 都 继承 自 BroadcastReceiver 类 。 
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Broadcast Receiver 不 包含 任何 用 户 界面 。 当 系统 或 某 个 应 用 程序 发 送 了 广播 时 ,可 以 使 
用 BroadcastReceiver 组 件 来 接收 广播 消息 ,并 做 出 相应 的 处 理 ,如 : 闪 动 背景 灯 、 振 动 设备 、 
发 出 声音 等 。 通 常 程序 会 在 状态 栏 上 放置 一 个 持久 的 图 标 , 用 户 可 以 打开 这 个 图 标 并 读 取 通 
知 信息 。 

BroadcastReceiver 的 使 用 过 程 如 下 。 

CD 将 信息 封装 ,并 添加 到 一 个 Intent 对 象 中 。 

(2) 然后 通过 调用 Context. sendBroadcast ( ), Context. sendOrderedBroadcast ( ) 或 
Context. sendStickyBroadcast O 77 iE ff. Intent 对 象 广播 出 去 。 

(3) 接收 者 检查 注册 的 IntentFilter 是 否 与 收 到 的 Intent 相同 。 

(4) 如 果 相 同 便 会 调用 onReceive() 方 法 来 接收 消息 。 

BroadcastReceiver 的 三 个 发 送 方法 的 不 同 之 处 是 ; 使 用 sendBroadcast() 或 sendStickyBroadcast() 
方法 时 ,所 有 满足 条 件 的 接收 者 都 会 随机 地 执行 ,而 使 用 sendOrderedBroadcast() 方 法 时 , 接 
收 者 会 根据 IntentFilter 中 设置 的 优先 级 顺序 地 来 执行 。 

需要 注意 的 是 ,使 用 BroadcastReceiver 需要 先 注册 。 注 册 BroadcastReceiver 对 象 的 方式 
有 两 种 ,一 种 是 在 AndroidManifest. xml 中 声明 , 另 一 种 是 在 Java 代码 中 设置 。 

(1) 在 AndroidManifest. xml 中 声明 时 ,要 将 注册 的 信息 放 在 二 receiver 二 二 /receiver 二 
标签 之 中 ,并 通过 二 intent-filter 二 标签 来 设置 过 滤 条 件 。 

(2) f£ Java 代码 中 设置 时 ,需要 先 创 建 IntentFilter 对 象 ,并 在 IntentFilter 对 象 内 设置 
Intent 过 滤 条 件 ,再 通过 调用 Context. registerReceiver() 方 法 来 注册 监听 ,然后 通过 Context. 
unregisterReceiver( ) 方 法 来 取消 监听 。 用 此 方式 的 缺点 是 当 Context 对 象 被 销毁 时 ,该 
BroadcastReceiver 对 象 也 就 随 之 被 销毁 了 。 


4. Intent 


1) Intent 概述 

Intent 就 是 连接 各 组 件 的 桥梁 ,是 一 种 运行 时 的 绑 定 机 制 ,Android 提供 了 Intent 机 制 来 
协助 应 用 间 的 交互 与 通信 。Intent 负责 对 应 用 中 一 次 操作 的 动作 \ 动 作 涉 及 数据 .附加 数据 进 
行 描述 ,Android 则 根据 此 Intent 的 描述 ,负责 找到 对 应 的 组 件 , 将 Intent 传递 给 调用 的 组 件 ， 
并 完成 组 件 的 调用 。Intent 不 仅 可 用 于 应 用 程序 内 部 的 Activity、Service 和 
BroadcastReceiver 之 间 的 交互 ,也 可 用 于 应 用 程序 之 间 的 交互 。 因 此 ,可 以 将 Intent 理解 为 
不 同 组 件 之 间 通 信 的 “媒介 ”, 专 门 提 供 组 件 互相 调用 的 相关 信息 。 

前 面 介绍 的 Activity Service 和 BroadcastReceiver 组 件 之 间 的 通信 全 部 使 用 的 是 Intent, 
但 是 各 个 组 件 使 用 的 Intent 机 制 不 同 。 

CD 当 需 要 激活 Activity 组 件 时 ,调用 Context. startActivity() 或 Context. startActivityForResult OÓ 
方法 来 传递 Intent。 

(2) 当 需 要 激活 Service 组 件 时 ,调用 Context. startService O 3X Context. bind Service () 
方法 来 传递 Intent, 

(3) 当 需 要 使 用 BroadcastReceiver 组 件 时 ,调用 sendBroadcast O , sendStickyBroadcast C) 7X 
sendOrderedBroadcast() 方 法 来 传递 Intent. 当 BroadcastReceiver 被 广播 后 ,所 有 IntentFilter 过 滤 
条 件 满足 的 组 件 都 将 被 激活 。 

Intent Æ rH H fF fi , Action, Data, Category, Extra 及 Flag 6 部 分 组 成 的 ,在 第 3 章 中 将 
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对 其 进行 详细 的 介绍 。 

2) IntentFilter 

IntentFilter(Intent 过 滤器 ) 正 如 其 英文 的 意思 ,是 Intent 过 滤器 。 一 个 应 用 程序 开发 完 
成 后 ,需要 告诉 Android 系统 自己 能 够 处 理 哪 些 隐 性 的 Intent 请 求 , 这 就 需要 声明 
IntentFilter。 通 常 在 AndroidManifest. xml 文件 中 声明 。IntentFilter 的 使 用 方法 实际 上 非 
常 简单 ,只 须 在 AndroidManifest. xml 中 的 二 Intentrfilter 二 标签 指定 该 应 用 程序 能 接收 的 
Intent 值 即 可 ,在 一 个 二 Intent-filter 之 标签 中 可 以 设置 多 个 过 滤 值 。 


5. Content Provider 


Content Provider 用 来 管理 和 共享 应 用 程序 的 数据 存储 ,是 Android 提供 的 一 种 标准 的 
共享 数据 的 机 制 。 在 应 用 程序 间 ,Content Provider 是 共享 数据 的 首选 方式 。 这 意味 着 ,用 户 
可 以 配置 自己 的 Content Provider 去 存 取 其 他 的 应 用 程序 或 者 通过 其 他 应 用 程序 暴露 的 
Content Provider 去 存 取 它们 的 数据 。Content Provider 都 继承 自 ContentProvider 25, 

Content Provider 创建 其 他 程序 使 用 的 数据 集 。 数 据 可 以 存在 系统 的 SQLite 数据 库 或 
者 其 他 地 方 。ContentProvider 通过 实现 一 组 标准 的 方法 ,来 使 其 他 程序 可 以 存 取 数据 。 但 
是 ,程序 并 不 是 直接 调用 这 些 方 法 ,而 是 使 用 ContentResolver 对 象 来 调用 这 些 方法 。 对 于 
ContentProvider 而 言 ,最 重要 的 就 是 数据 模型 (Data Model) 和 URI。 

CD 数据 模型 (Data Model), ContentProvider 为 所 有 需要 共享 的 数据 创建 一 个 数据 表 ， 
在 表 中 ,每 一 行 表示 一 条 记录 ,而 每 一 列 代表 某 个 数据 ,并 且 其 中 每 一 条 数据 记录 都 包含 一 个 
名 为 “_ID” 的 字段 类 标识 每 条 数据 。 

(2) URI(Uniform Resource Identifier, 通 用 资源 标识 符 )。 每 个 ContentProvider 都 会 对 
外 提供 一 个 公开 的 URI 来 标识 自己 的 数据 集 。URI 主要 分 为 三 个 部 分 : scheme、authority 
和 path, 其 中 authority 又 分 为 host 和 port。 其 格式 为 “scheme://host: port/path”。 在 
Android 中 ,所 有 的 URI 都 以 “content://” 开 头 , 例 如 ;“content://com. example. project: 
200/folder/subfolder/etc" 。 

需要 注意 的 是 ,使 用 ContentProvider 访问 共享 资源 时 ,要 为 应 用 程序 添加 适当 的 权限 。 
在 应 用 程序 的 AndroidManifest. xml 文件 中 添加 权限 “二 uses-permission android: name = 
"android. permission. READ_CONTACTS"/>”, 


6. Notification 


Notification 用 来 在 不 需要 焦点 或 不 中 断 它 们 当前 Activity 的 情况 下 提示 用 户 。 它 们 是 
Service 或 Broadcast Receiver 获得 用 户 注意 的 首选 方式 。 例 如 , 当 设 备 收 到 文本 信息 或 外 部 
来 电 时 , 它 通过 闪光 发声 \ 显 示 图 标 或 显示 对 话 框 信息 来 提醒 用 户 。 


@.4 AndroidManifest. xml 文件 


从 本 章 的 前 面 叙述 中 ,可 以 体会 到 应 用 程序 的 功能 清单 文件 AndroidManifest. xml 非常 
重要 ,每 一 个 应 用 程序 不 可 缺少 。 下 面 对 该 文件 进行 详细 介绍 。 
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2.4.1 AndroidManifest. xml 的 主要 构成 


AndroidManifest. xml 是 应 用 程序 的 全 局 描述 文件 , 它 让 外 界 知道 该 应 用 程序 包含 哪些 
组 件 、 哪 些 资源 及 何 时 运行 该 程序 等 信息 。 其 主要 内 容 如 下 。 

避 应 用 程序 的 包 名 ,该 包 名 将 作为 应 用 程序 的 唯一 标识 符 。 

名 包含 的 组 件 如 : Activity、Service、BroadcastReceiver 及 ContentProvider 等 。 

马 应 用 程序 兼容 的 最 低 版 本 。 

马 声 明 应 用 程序 需要 的 链接 库 。 

避 声 明 应 用 程序 自身 应 该 具有 的 权限 。 

总 其他 应 用 程序 访问 该 应 用 程序 时 应 该 具有 的 权限 。 

当 新 创建 一 个 应 用 项 目 时 , 系统 会 自动 生成 AndroidManifest. xml 文件 。 但 是 从 
HelloAndroid 项 目 中 可 以 看 到 ,生成 的 AndroidManifest. xml 文件 信息 不 多 ,真正 有 实用 价值 
的 应 用 都 需要 对 它 进 行 再 编辑 。 在 Eclipse 的 默认 情况 下 , 刚 一 打开 项 目的 AndroidManifest. 
xml 文件 ,会 看 到 一 个 可 视 化 编辑 器 ,如 图 2-4 所 示 。 


E ZSWB. Loginl Manifest 
«$* Android Manifest 


~ Manifest General Attributes. 
Defines general information about the AndroidManifestxml 


Package €n.com.sgmsc Hello 


Versioncode — 1 


Version name — 10 


Shared user id 


Shared user label 


Install location 


Manifest Extras € & 9 9 (9) 6 A: 


2-4  AndroidManifest. xml 的 可 视 化 编辑 器 


图 2-4 是 Android 的 ADT 插件 提供 的 可 视 化 编辑 器 ,通过 选项 的 输入 和 设置 可 以 完成 
AndroidManifest. xml 文件 。 但 是 作为 一 位 程序 员 , 更 多 地 是 选择 直接 进行 录入 编辑 。 即 单 
击 该 编辑 器 下 方 的 AndroidManifest. xml 标签 ,进入 编辑 页 ,如 图 2-5 所 示 。 

下 面 分 别 讲 解 AndroidManifest. xml 文件 中 的 标签 。 

AndroidManifest. xml 文件 是 以 XML 格式 描述 ,开头 都 会 出 现 “ 二 ?xml version 一 "1. 0" 
encoding— "utf-8" ? >” R EE E , < manifest > fj 4 ÆR 45 93 , AndroidManifest. xml 的 其 他 
标签 都 定义 在 该 标签 下 。 在 此 标签 的 属性 中 必须 要 指定 “xmlns:android 一 "http ://schemas. 
android. com/apk/res/android"”, 并 且 声 明了 应 用 程序 所 在 的 包 名 、 版 本 号 。 

代码 : 


package = " cn. com. sgmsc. Hello" 
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?xml version-"1.0" encoding-"utf-6"7» 
G «manifest xmlns:androide"http://schemas.android.com/apk/res/android" 
package="cn. com. sgmsc. Hello" 
android:versionCode="i" 
android:versionName-"i.0" > 


<uses-sdk android:minSdkVersion="10" /> 


«application 
android:icon-"fdravable/ic launcher" 
android:label-"$string/app name" > 
«activity 

android:name-".Hello" 
android:labele"ástring/app name" > 
<intent-filter> 
<action android:name="android. intent.action. MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</nanifest> 


国 Manifest [A] Application |(P] Permissions (1) Instrumentation | 司 AndroidManifestxml 


图 2-5 AndroidManifest. xml 的 编辑 页 


“package" 是 二 manifest 一 标签 的 一 个 特别 属性 , 它 声 明了 应 用 程序 所 在 的 包 名 , 即 指定 这 
个 应 用 程序 的 进入 点 存在 于 “cn. com. sgmsc. Hello” 这 个 名 称 空间 路 径 中 。 
代码 ， 


android:versionCode - "1" 
android:versionName = "1.0" 


"android: versionCode" fll “android; versionName” 是 应 用 程序 版 本 号 。 这 两 个 属性 是 可 
选 的 ( 非 必 要 )。“android:versionName” 是 给 使 用 者 看 的 版 本 号 ， 如 *1.0”、“2. 0”。“android: 
versionCode” 则 是 开发 者 用 的 内 部 版 本 号 一般 使 用 流水 号 。 

代码 : 


« uses - sdk android:minSdkVersion = "10" /> 


Android SDK 1.1 版 之 后 引入 了 这 条 叙述 。 透 过 指定 这 个 参数 ,系统 可 以 依 此 辨别 应 用 
程序 是 否 使 用 相 容 的 SDK 版 本 ,以 决定 能 否 在 这 台 机 器 上 安装 执行 。“1? 代 表 Android SDK 
1.0,“2? 代 表 SDK 1. 1,“3” 代 表 SDK 1.5,“10” 代 表 SDK 2. 3. 3。 这 也 是 一 个 可 选 填 的 选项 。 
但 如 果 应 用 程序 要 发 布 出 去 ,一 些 强势 的 应 用 发 布 平 台 如 Google Android Market 已 规定 所 
有 新 发 布 的 应 用 程序 必须 指定 “android:minSdkVersion” 这 个 参数 。 

在 二 manifest 盖 标签 中 可 以 包含 0 个 或 1 个 二 application 二 标签 。 见 如 下 代码 。 


« application android: icon = "@drawable/icon" android: label = "@string/app_name"> 


</application> 


在 二 application 之 标签 内 ,定义 所 有 这 个 应 用 程序 用 到 的 Activity, Service 等 信息 。 标 签 
中 的 “android:icon” 属 性 ,定义 了 这 个 应 用 程序 将 显示 在 Android 主 画 面 中 的 应 用 程序 图 标 。 
"android: icon — " (9 drawable/icon"” 表 示 应 用 程序 图 标 取 自 资源 “res/drawable/icon”; 
“android :label” 属 性 可 用 来 指定 应 用 程序 将 显示 在 Home 主 画 面 上 的 名 称 ,也 就 是 预 设 刚 开 
好 机 时 ,可 以 从 桌面 下 方 拉 出 的 应 用 程序 列表 项 。 
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在 AndroidManifest. xml 中 有 时 还 要 声明 权限 ,这 部 分 内 容 将 在 2. 4. 2 节 中 说 明 。 下 面 
来 讲 讲 在 二 application 过 标签 中 对 应 用 程序 所 包含 的 组 件 如 何 进 行 声明 。 

在 二 application 二 标签 中 可 以 包含 0 个 或 多 个 Activity、Service、BroadcastReceiver 及 
ContentProvider 等 组 件 的 声明 。 如 果 已 经 在 程序 代码 中 定义 好 了 组 件 , 例 如 已 定义 好 一 个 
Activity, 却 没有 在 “AndroidManifest. xml” 中 加 入 相应 “activity” 节 点 ,那么 在 执行 时 是 无 法 启 
动 这 个 Activity 的 。 其 他 的 组 件 也 是 一 样 。 


1. «activity fx € 


Activity 组 件 使 用 二 activity 二 标签 ,例如 下 列 代码 : 


1 «activity android:name = ".Hello" android: label = "@string/app_name"> 

2 «intent- filter» 

3 < action android:name = "android. intent. action. MAIN" /> 

4 < category android:name = "android. intent. category. LAUNCHER" /> 

5  «/intent- filter» 

6 «activity» 

activity flJ "android: name" fii E . d tH. T 3X 47. Activity 所 对 应 的 类 。 因 为 在 上 一 层 
—manifesi fj 4 JB E rj B. E X. Y" package" cn. com. sgmsc. Hello"”, 所 以 类 名 就 是 在 此 
包 下 的 类 “. Hello”。“android:label” 属 性 可 用 来 指定 应 用 程序 将 显示 在 Activity 画面 上 方 标 
题 栏 的 名 称 。 

在 一 activity 之 标签 中 一 般 需 要 定义 0 个 或 多 个 二 intent-filter 二 声明 ,用 于 设置 该 
— activity f Intent 过 滤 条 件 。 二 intent-filter 二 中 主要 包含 两 个 子 标签 :“action” 和 
“category”, 用 于 设置 其 Intent 过 滤 条 件 ,来 实现 与 其 他 组 件 的 通信 。 三 action 二 标签 中 的 
“android:name” 属 性 ,其 内 容 “android. intent. action. MAIN” 表 示 : 这 个 Activity 是 此 应 用 程 
序 为 进入 点 (就 像 Java 程序 中 常见 的 main 主 程序 一 样 ) ,开启 这 个 应 用 程序 时 ,应 先 执行 这 个 
Activity, category > bj 4& (P HJ “android: name” 属 性 , 其 内 容 “android. intent. category. 
LAUNCHER"” 表 示 : 这 个 Activity 将 显示 在 Launcher 的 应 用 程序 列表 中 。 

于 是 ,可 以 这 样 理解 HelloAndroid 应 用 的 AndroidManifest. xml 文件 所 传达 的 信息 : 在 
“cn. com. sgmsc. Hello” 路 径 下 的 “Hello. java” 这 个 文件 中 ,已 定义 了 一 个 主要 的 Activity; 当 
打开 Android 的 时 候 , 显 示 的 是 位 于 “res/drawable/icon” 的 图 示 。 一 旦 按 下 图 示 来 启动 这 个 
应 用 程序 ,Android 应 用 程序 框架 会 去 寻找 到 定义 了 “android. intent. action. MAIN” 内 容 的 
*. Hello” Activity 并 呼叫 执行 , 它 定义 在 “Hello. java” 文 件 中 。 

HelloAndriod 是 一 个 非常 简单 的 应 用 程序 ,所 以 在 AndroidManifest. xml 中 没有 包含 其 
他 的 组 件 声明 ,下 面 对 其 他 的 组 件 声明 作 简 单 介绍 。 


2. 一 service 二 标签 


Service 组 件 使 用 一 service 二 标签 ,除了 没有 屏幕 显示 外 ,其 他 的 定义 与 Activity 几乎 一 
样 , 也 可 以 在 该 节点 下 包含 二 intentfilter 之 等 声明 ,通过 Intent 可 实现 与 其 他 组 件 的 通信 。 例 
如 下 列 代码 : 

1 «service 


2 android:enabled = "true" android:name = ".MyService"» 
3 «/service» 
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3. <receiver> iR% 


BroadcastReceiver 组 件 使 用 一 receiver 之 标签 , 它 与 二 service 之 标签 的 定义 差不多 ,也 可 
以 在 该 节点 下 包含 二 intent-filter 志 等 声明 ,通过 Intent 可 实现 与 其 他 组 件 的 通信 。 例 如 下 列 
代码 : 


1 «receiver android:enabled = "true" 

2 android: label = "My Broadcast Receiver" 
3 android: name = ". MyBroadcastReceiver"» 
4 </receiver> 


4. <provider> fx € 


ContentProvider 组 件 使 用 一 provider 二 标签 , 它 通 过 一 组 标准 的 方法 接口 ,以 及 相应 的 权 
限 , 用 来 实现 数据 的 共享 。 例 如 下 列 代码 : 


1 «provider android:permission = "com. paad.MY PERMISSION" 


2 android:name = ". MyContentProvider" 
3 android:enabled- "true" 
4 android:authorities = "com. paad. myapp. MyContentProvider"» 


5 «/provider» 


2.4.2 应 用 程序 的 权限 


有 时 在 AndroidManifest. xml 文件 中 还 需 指定 相应 的 权限 ,使 得 应 用 程序 能 够 正常 工作 ， 
或 者 程序 包 必 须 被 授予 该 权限 ,以 限制 哪些 应 用 可 以 访问 指定 的 程序 包 内 的 组 件 和 特有 功能 。 
例如 网 络 权限 .发送 短信 权限 等 。 

在 AndroidManifest. xml 中 声明 权限 使 用 过 uses-permission 之 标签 ,例如 下 列 代码 

1 <uses - permission 

2 android:name = "android. permission. ACCESS FINE LOCATION" 

3 «/uses- permission» 

描述 权限 使 用 “android. permission. 权限 常量 ”格式 ,权限 常量 由 大 写 英文 单词 加 下 划 线 
“_” 组 成 。 表 2-1 中 列 出 部 分 常用 的 权限 常量 。 


表 2-1 部 分 常用 的 权限 常量 


权限 常量 & X 
ACCESS FINE LOCATION 允许 一 个 程序 访问 精良 位 置 (如 GPS) 
ACCESS LOCATION EXTRA COMMANDS 允许 应 用 程序 访问 额外 的 位 置 提供 命令 
ACCESS WIFI STATE 允许 程序 访问 Wi-Fi 网 络 状态 信息 
ADD_SYSTEM_SERVICE 允许 程序 发 布 系统 级 服务 
BATTERY STATS 允许 程序 更 新 手机 电池 统计 信息 
BLUETOOTH 允许 程序 连接 到 已 配对 的 蓝牙 设备 
BLUETOOTH ADMIN 允许 程序 发 现 和 配对 蓝牙 设备 
CALL_PHONE 允许 一 个 程序 初始 化 一 个 电话 拨号 ,不 需 通过 拨号 用 


户 界面 来 确认 
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续 表 

权限 常量 & x 
CAMERA 请 求 访问 使 用 照相 设备 
CHANGE CONFIGURATION 允许 一 个 程序 修改 当前 设置 ,如 本 地 化 
CHANGE_NETWORK_STATE 允许 程序 改变 网 络 连 接 状 态 
CHANGE WIFI STATE 允许 程序 改变 Wi-Fi 连接 状态 
FLASHLIGHT 允许 访问 设备 上 的 闪光 灯 
INTERNET 允许 程序 打开 网 络 套 接 字 
READ CALENDAR 允许 程序 读 取 用 户 日 历数 据 
READ_CONTACTS 允许 程序 读 取 用 户 联系 人 数据 
READ_SMS 允许 程序 读 取 短 信息 
REBOOT 请 求 能 够 重新 启动 设备 
RECEIVE_SMS 允许 程序 监控 一 个 将 收 到 短信 息 ,记录 或 处 理 
SEND_SMS 允许 程序 发 送 SMS 短信 
SET_TIME_ZONE 允许 程序 设置 时 间 区 域 
SET_WALLPAPER 允许 程序 设置 壁纸 
VIBRATE 允许 访问 振动 设备 
WRITE CALENDAR 允许 一 个 程序 写 入 但 不 读 取 用 户 日 历数 据 
WRITE_CONTACTS 允许 程序 写 入 但 不 读 取 用 户 联系 人 数据 
WRITE_GSERVICES 允许 程序 修改 Google 服务 地 图 
WRITE_OWNER_DATA 允许 一 个 程序 写 和 但 不 读 取 所 有 者 数据 
WRITE_SMS 允许 程序 写 短信 


2.4.8 范例 


在 下 载 并 安装 了 Android SDK 之 后 ,在 其 安装 目录 下 会 有 一 些 范例 。 在 第 1 章 的 系统 环 
境 安装 时 ,SDK 的 安装 路 径 为 EE:\android-sdk, 该 文件 夹 下 有 个 “samples” 子 文件 夹 , 这 里 面 有 
一 些 经 典 的 Android 应 用 程序 示例 ,分 别 以 不 同 的 SOK 版 本 组 织 在 不 同 的 子 文件 夹 中 。 打 开 
EE:\android-sdk\samples\android-10 中 的 NotePad 项 目 , 打 开 其 AndroidManifest. xml X fff. 
代码 如 下 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 

2 «!-- Copyright (C) 2007 The Android Open Source Project 

3 

4 Licensed under the Apache License, Version 2.0 (the "License"); 

5 you may not use this file except in compliance with the License. 

6 You may obtain a copy of the License at 

" 

8 http://www. apache. org/licenses/LICENSE - 2.0 

9 

10 Unless required by applicable law or agreed to in writing, software 
11 distributed under the License is distributed on an "AS IS" BASIS, 

12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
13 See the License for the specific language governing permissions and 
14 limitations under the License. 

15 --2- 


16 
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<! — Declare the contents of this Android application. The namespace 
attribute brings in the Android platform namespace, and the package 
supplies a unique name for the application. When writing your 
own application, the package name must be changed from "com. example. * 
to come from a domain that you own or have control over. 一 一 > 

< manifest xmlns:android = "http: //schemas. android. con/apk/res/android" 
package 7 "con. example. android. notepad" » 


« application android: icon = "(Qdrawable/app notes" 
android: label = "(3string/app name" > 
< provider android:name = "NotePadProvider" 
android:authorities = "com. example. notepad. provider. NotePad" /> 


«activity android:name = "NotesList" 
android: label = "(Qstring/title notes list"» 
< intent - filter» 
< action android:name = "android. intent. action. MAIN" /> 
< category android:name = "android. intent. category. LAUNCHER" /> 
«/ intent - filter» 
«intent - filter > 
< action android:name = "android. intent. action. VIEW" /> 
X action android:nam android. intent. action. EDIT" /> 
« action android:name = "android. intent. action. PICK" /> 
< category android:name = "android. intent.category. DEFAULT" /> 
< data android:mimeType = "vnd. android. cursor. dir/vnd. google. note" /> 
«/ intent - filter» 
< intent - filter» 
« action android:name = "android. intent.action.GET CONTENT" /> 
< category android:name = "android. intent. category. DEFAULT" /> 
< data android:mimeType = "vnd. android. cursor. iten/vnd. google. note" /> 
«/intent - filter» 
«/activity» 


< activity android:name = "NoteEditor" 
android: theme = "(2 android:style/Theme. Light" 
android:configChanges = "keyboardHidden|orientation"» 
<! —— This filter says that we can view or edit the data of 
a single note --> 
< intent - filter android: label = "(Ustring/resolve edit"» 
« action android:name = "android. intent. action. VIEW" /> 
X action android:name = "android. intent. action. EDIT" /> 
« action android:name = "com. android. notes. action. EDIT NOTE" /> 
< category android:name = "android. intent.category. DEFAULT" /> 
< data android:mimeType = "vnd. android. cursor. item/vnd. google. note" /> 
«/ intent - filter» 


<! — This filter says that we can create a new note inside 
of a directory of notes. 一 一 > 
«intent - filter > 
« action android:name = "android. intent. action. INSERT" /> 
« category android:name - "android. intent.category. DEFAULT" /» 
< data android:mimeType - "vnd. android. cursor. dir/vnd. google. note" /> 
«/ intent - filter» 


«/activity? 
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72 

73 <activity android:name = "TitleEditor" 

74 android: label = "@string/title_edit_title" 

75 android: theme = "@android: style/Theme. Dialog" 

76 android: icon = "@drawable/ic_menu_edit" 

TP android:windowSoftInputMode = "stateVisible"> 

78 <! -- This activity implements an alternative action that can be 

79 performed on notes: editing their title. It can be used as 

80 a default operation if the user invokes this action, and is 

81 available as an alternative action for any note data. --> 

82 < intent - filter android: label = "(Ustring/resolve title"» 

83 <! -- This is the action we perform. It is a custom action we 

84 define for our application, not a generic VIEW or EDIT 

85 action since we are not a general note viewer/editor. --» 

86 « action android:name - "com. android. notepad. action.EDIT TITLE" /> 
87 <! -- DEFAULT: execute if being directly invoked. --» 

88 < category android:name = "android. intent.category. DEFAULT" /> 

89 <! —— ALTERNATIVE: show as an alternative action when the user is 
90 working with this type of data. --» 

91 < category android:name = "android. intent. category. ALTERNATIVE" /> 
92 <! -- SELECTED ALTERNATIVE: show as an alternative action the user 
93 can perform when selecting this type of data. --> 

94 < category android:name = "android. intent. category. SELECTED ALTERNATIVE" /> 
95 X! -- This is the data type we operate on. --» 

96 < data android:mimeType - "vnd. android. cursor. item/vnd. google. note" /> 
97 «/intent - filter» 

98 «/activity? 

99 

100 « activity android:name = "NotesLiveFolder" 

101 android: label = "(Qstring/live folder name" 

102 android: icon = "(Qdrawable/live folder notes"» 

103 < intent - filter > 

104 « action android:name = "android. intent. action. CREATE LIVE FOLDER" /> 
105 X category android:name = "android. intent. category. DEFAULT" /> 

106 «/intent - filter? 

107 X/activity» 

108 

109 «/application? 

110 


111 « uses - sdk android:minSdkVersion = "3" android:targetSdkVersion = "4"/» 

112 </manifest> 

CD 第 2 一 21 行 是 关于 这 个 示例 的 注释 ,说 明 这 个 示例 的 权 属 和 版 本 ,以 及 出 处 等 信息 。 

(2) 第 22—112 fT35E X. — manifest ^ 15 , 

(3) 第 25—109 ÍF X. — application? 45 A, Æ Kr ig X  — A< provider 45 £4 ^ 
activity > 5 gà 3x UB 48 DA 5 个 Java 代码 文件 NotePadProvider. java, NotesList. java. 
NoteEditor. java, TitleEditor. java 和 NotesLiveFolder. java. 

(4) 第 27—28 行 声 明了 一 个 ContentProvider 组 件 。 

(5) 第 30—48 行 声 明了 一 个 Activity 组 件 , 其 中 设置 了 三 个 IntentFilter 过 滤 信 息 。 

(6) 第 50—71 行 声明 了 一 个 Activity 组 件 , 其 中 设置 了 两 个 IntentFilter 过 滤 信 息 。 

(7) 第 73 一 98 行 声 明了 一 个 Activity 组 件 , 其 中 设置 了 一 个 IntentFilter 过 滤 信 息 。 

(8) 第 100—107 行 声明 了 一 个 Activity 组 件 , 其 中 设置 了 一 个 IntentFilter 过 滤 信息 。 


第 2 章 ”Android 应 用 程序 的 构成 


(9) 第 111 行 声明 Android SDK 的 最 低 版 本 号 和 与 目标 设备 的 API 版 本 相 匹 配 的 版 本 
号 ,指定 minSdkVersion 主要 是 为 了 声明 该 应 用 程序 的 兼容 性 。 


小 结 


本 章 主要 介绍 了 Android 应 用 程序 的 基本 架构 、 基 本 组 件 , 结 合 HelloAndroid 项 目 比 较 
详细 地 解析 了 Android 应 用 程序 的 组 成 。 由 于 功能 清单 文件 AndroidManifest. xml 在 
Android 应 用 项 目 中 的 至 关 重 要 性 ,专门 拿 出 来 进行 详细 说 明 。 相 信 读 者 已 经 对 Android 应 
用 程序 的 组 成 有 了 更 进一步 的 认识 。 

当然 , 想 要 知道 Android 系统 是 如 何 对 应 用 程序 的 这 些 组 件 、 控 件 及 数据 资源 进行 控制 
和 信息 通信 的 ? 将 在 第 3 章 中 进行 介绍 。 


练习 


理解 Android SDK 中 例 程 的 目录 结构 和 AndroidManifest. xml 文件 。 例 程 路 径 : SDK 
文件 夹 下 的 samples 子 文件 夹 中 ,本 书 是 E;\android-sdk\samples。 
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Android 应 用 程序 的 控制 机 制 | 


Android 应 用 程序 由 Activity, Service, Broadcast Receiver 和 Content Provider 等 组 件 组 
成 ,其 中 Activity 是 使 用 频率 最 高 .最 重要 的 组 件 。 在 Android 应 用 中 , Activity 提供 可 视 化 
的 用 户 界面 ,一 个 Android 应 用 通常 由 多 个 Activity 组 成 。 每 个 Activity 有 自己 的 生命 周期 ， 
一 个 Activity 组 件 结束 , 另 一 个 Activity 将 处 于 活动 状态 ,它们 组 成 了 一 个 应 用 任务 。 每 个 
Activity 的 状态 由 Android 系统 来 控制 。 想 要 知道 Android 应 用 程序 是 如 何 运行 控制 的 , 首 
先 必须 明白 Activity 组 件 在 应 用 程序 中 的 控制 机 制 。 


8.1 Android 应 用 程序 的 界面 
sq 


Activity 是 Android 应 用 程序 与 使 用 者 互动 的 主要 元 素 , 当 使 用 者 开启 一 个 应 用 程序 时 ， 
第 一 个 看 到 的 画面 就 是 一 个 Activity, fE Android 中 ,每 一 个 Activity 就 是 一 个 单独 的 屏幕 
显示 。 每 个 Activity 组 件 由 XML 布局 文件 ,Java 代码 文件 以 及 Activity 组 件 状 态 来 确定 它 
在 屏幕 上 显示 的 内 容 、 操 作 响应 和 显示 的 时 机 。 当 然 , 别 忘 了 一 定 要 在 AndroidManifest. xml 
中 声明 它 ,否则 将 看 不 到 它 。 

通常 把 Activity 中 的 内 容 在 屏幕 上 的 显示 称 作 用 户 界 面 (User Interface,UI) 。 在 用 户 界 
面 中 可 显示 的 内 容 有 很 多 ,如 文本 框 \ 按 钮 ,列表 框图 片 、 进 度 条 等 ,这 些 用 户 界面 元 素 称 为 控 
件 。 大 部 分 控件 是 可 见 的。 在 Android 中 ,所 有 的 可 视 控 件 都 继承 自 View 类 。View 类 提供 
了 绘制 和 事件 处 理 的 方法 。 

对 于 Activity 中 控件 的 绘制 , 既 可 以 使 用 XML 文件 描述 ,也 可 以 通过 成 员 方 法 在 Java 代 
码 中 动态 设置 。 但 本 着 MVC 的 设计 思想 ,通常 是 使 用 XML 文件 来 描述 界面 的 布局 ,而 对 于 
Activity 组 件 中 的 屏幕 控件 对 象 的 处 理 与 控制 , 则 使 用 Java 代码 进行 Activity 类 的 定义 。 

使 用 XML 声明 法 来 描述 应 用 程序 的 可 视 控 件 及 其 布局 信息 ,此 文件 称 为 布局 文件 。 每 
一 个 Activity 对 应 一 个 布局 文件 ,所 有 布局 文件 都 存放 在 应 用 项 目 目录 下 的 “res/layout” 子 目 
录 内 。 布 局 文件 只 定义 了 Activity 的 显示 内 容 , 但 并 没有 告诉 Android 什么 时 候 显示 它 。 

在 应 用 项 目 目录 下 的 “src” 目 录 的 包 内 ,存放 定义 此 Activity 类 的 Java 代码 文件 。 在 代码 
文件 中 定义 Activity 的 显示 时 机 ,以 及 显示 、 退 出 时 Activity 状态 信息 的 保存 与 恢复 ,用 户 交 
互 操 作 时 各 控件 的 事件 响应 等 控制 逻辑 。 每 个 定义 的 Activity 类 都 继承 自 android. app. 
Activity, 所 以 在 其 他 类 的 定义 代码 文件 前 部 都 必须 加 上 “import android. app. Activity;”。 

一 个 Activity 可 以 启动 男 外 一 个 ,甚至 包括 与 它 不 在 同一 应 用 程序 之 中 的 Activity。 举 
个 例子 ,假设 想 让 用 户 看 到 某 个 地 方 的 街道 地 图 ,而 已 经 存在 一 个 具有 此 功能 的 Activity T. 
那么 你 的 Activity 所 需要 做 的 工作 就 是 把 请 求 信息 放 到 一 个 Intent 对 象 里 面 ,并 把 它 传递 给 
startActivity() ,于 是 地 图 浏览 器 就 会 显示 那个 地 图 。 而 当 用 户 按 下 BACK 键 的 时 候 , 你 的 
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Activity 又 会 再 一 次 显示 在 屏幕 上 。 对 于 用 户 来 说 ,这 看 起 来 就 像 是 地 图 浏览 器 是 你 Activity 
所 在 的 应 用 程序 中 的 一 个 组 成 部 分 ,其 实 它 是 在 另外 一 个 应 用 程序 中 定义 ,并 运行 在 那个 应 用 
程序 的 进程 之 中 的 。 

关于 Android 中 的 组 件 和 应 用 ,之 前 涉及 的 大 都 是 静态 的 概念 。 而 当 一 个 应 用 运行 起 来 ， 
就 难免 会 需要 关心 进程 线程 这 样 的 概念 。 


6.2 Android 应 用 程序 的 任务 .进程 和 线程 


在 Android 中 ,组 件 的 动态 运行 有 一 个 最 与 众 不 同 的 概念 ,就 是 任务 (Task )。 任 务 的 介入 ， 
最 主要 的 作用 是 将 组 件 之 间 的 连接 从 进程 概念 的 细节 中 剥离 出 来 ,可 以 以 一 种 不 同 模型 的 东西 
进行 配置 ,在 很 多 时 候 , 能 够 简化 上 层 开发 人 员 的 理解 难度 ,帮助 读者 更 好 地 进行 开发 和 配置 。 


3.2.1 任务 


完成 用 户 的 一 个 目的 的 所 有 Activity 组 成 一 个 任务 。 确 切 地 说 ,任务 是 一 组 以 栈 的 模式 
将 这 些 Activity 组 件 聚 集 在 一 起 的 集合 ,这 个 栈 称 作 任务 栈 (Task Stack), Android 系统 用 一 
个 任务 栈 来 记录 一 个 任务 ,它们 有 潜在 的 前 后 驱 关 联 , 新 加 入 的 Activity 组 件 , 位 于 栈 项 ,并 仅 
有 在 栈 顶 的 Activity, 才 会 有 机 会 与 用 户 进行 交互 。 而 当 栈 顶 的 Activity 完成 使 命 退出 的 时 
候 , 任 务 会 将 其 退 栈 , 并 让 下 一 个 将 跑 到 栈 顶 的 Activity 来 与 用 户 面对面 ,直至 栈 中 再 无 更 多 
的 Activity, 任 务 结束 。 

以 收发 邮件 任务 为 例 , 通 常 接收 并 回复 邮件 会 依次 进行 下 述 操 作 , 描 述 如 下 。 

(1) 首先 是 单 击 E-mail 应 用 ,进入 收 件 箱 , 这 部 分 由 Activity A 完成 。 

(2) 选中 一 封 邮件 , 单 击 查看 详情 ,这 部 分 由 Activity B 完成 。 

(3) 单 击 “ 回 复 ”, 开 始 写 新 邮件 ,这 部 分 由 Activity C 完成 。 

(4) 写 几 行 字 ,选择 联系 人 ,进入 选择 联系 人 界面 ,这 部 分 由 Activity D 完成 。 

(5) 选择 好 联系 人 ,继续 写 邮 件 。 

(6) 写 好 邮件 ,发 送 , 回 到 原始 邮件 。 

(7) 返回 到 收 件 箱 。 

(8) 退出 E-mail 程序 。 

那么 ,任务 栈 会 随 着 操作 事件 的 变化 而 发 生 相应 的 变化 ,其 过 程 如 表 3-1 所 示 。 


表 3-1 收发 邮件 任务 栈 的 动态 变化 


事 件 Task $È 
单 击 E-mail 应 用 ,进入 收 件 箱 [a 
选中 一 封 邮件 , 单 击 查看 详情 AB 
单 击 “ 回 复 ”, 开 始 写 新 邮件 ABC 
写 几 行 字 , 选 择 联系 人 ,进入 选择 联系 人 界面 ABCD 
选择 好 联系 人 ,继续 写 邮件 ABC 
写 好 邮件 ,发 送 , 回 到 原始 邮件 AB 
返回 到 收 件 箱 [^ 
退出 E-mail 程序 LN 
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表 3-1 描述 了 收发 邮件 的 一 个 实例 。 从 用 户 一 进入 邮箱 开始 ,到 回复 完成 ,退出 应 用 整个 
过 程 的 任务 栈 变化 。 这 是 一 个 标准 的 栈 模式 ,对 于 大 部 分 的 状况 ,这 样 的 任务 模型 足以 应 付 ， 
但 是 在 实际 开发 中 ,还 要 考虑 到 应 用 的 性 能 .开销 等 问题 。 例 如 ,启动 一 个 浏览 器 ,在 Android 
中 是 一 个 比较 沉重 的 过 程 , 它 需要 做 很 多 初始 化 的 工作 ,并 且 会 有 不 小 的 内 存 开销 。 但 与 此 同 
时 ,用 浏览 器 打开 一 些 内 容 , 又 是 一 般 应 用 都 会 有 的 一 个 需求 。 试 设想 一 下 ,如 果 同 时 有 10 个 
运行 着 的 应 用 都 需要 启动 浏览 器 ,就 会 有 10 个 任务 栈 都 堆积 着 很 雷同 的 浏览 器 Activity, 这 
将 是 一 个 多 么 奢侈 的 浪费 ! 于 是 ,可 以 这 样 设想 ,浏览 器 Activity 可 不 可 以 作为 一 个 单独 的 任 
务 而 存在 ,不 管 是 来 自 哪个 任务 的 请 求 ,浏览 器 的 任务 都 不 会 归并 过 去 。 这 样 ,虽然 浏览 器 
Activity 本 身 需要 维系 的 状态 更 多 了 ,但 整体 的 开销 将 大 大 减少 。 


3.2.2 进程 


进程 是 低级 核心 处 理 过 程 ,用 于 运行 应 用 程序 代码 。 当 某 个 组 件 第 一 次 运行 的 时 候 ， 
Android 就 启动 了 一 个 进程 。 默认 情况 下 ,所 有 的 组 件 和 程序 运行 在 这 个 进程 和 线程 中 。 

当然 ,也 可 以 安排 组 件 在 其 他 的 进程 或 者 线程 中 运行 进程 ,组 件 运行 的 进程 由 
Androidmanifest X ^E il. HFR AE — activity . — service , — receiver > H< provider > fif 
包含 一 个 process 属性 。 这 个 属性 可 以 设置 组 件 运行 的 进程 : 可 以 配置 组 件 在 一 个 独立 进程 
运行 ,或 者 多 个 组 件 在 同一 个 进程 运行 。 甚 至 可 以 多 个 程序 在 一 个 进程 中 运行 ,前 提 是 如 果 这 
些 程序 共享 一 个 UserID, 并 且 给 定 同样 的 权限 。 志 application tR ABE A process 属性 ,用 
来 设置 程序 中 所 有 组 件 的 默认 进程 。 

所 有 的 组 件 在 此 进程 的 主线 程 中 实例 化 ,系统 对 这 些 组 件 的 调用 从 主线 程 中 分 离 。 并 非 
每 个 对 象 都 会 从 主线 程 中 分 离 。 一 般 来 说 ,响应 例如 View. onkeydown() 用 户 操作 的 方法 和 
通知 的 方法 也 在 主线 程 中 运行 。 这 就 表示 ,组 件 被 系统 调用 的 时 候 不 应 该 长 时 间 运 行 或 者 阻 
塞 操作 (如 网 络 操作 或 者 计算 大 量 数据 ), 因 为 这 样 会 阻塞 进程 中 的 其 他 组 件 。 可 以 把 这 类 操 
作 从 主线 程 中 分 离 。 

当 更 加 常用 的 进程 无 法 获取 足够 内 存 ,Android 可 能 会 关闭 不 常用 的 进程 。 下 次 启动 程 
序 的 时 候 会 重新 启动 进程 。 在 决定 哪个 进程 需要 被 关闭 的 时 候 ,Android 会 考虑 哪个 对 用 户 
更 加 有 用 。 如 Android 会 倾向 于 关闭 一 个 长 期 不 显示 在 界面 的 进程 来 支持 一 个 经 常 显示 在 界 
面 的 进程 。 是 否 关闭 一 个 进程 决定 于 组 件 在 进程 中 的 状态 。 


1. 进程 分 类 


Android 系统 会 根据 运行 于 进程 内 的 组 件 和 组 件 的 状态 把 进程 置 于 5 种 不 同 的 重要 性 等 
级 。 当 需要 系统 资源 时 ,重要 性 等 级 越 低 的 先 被 淘汰 。 下 面 按 重 要 性 等 级 由 高 到 低 介绍 这 5 
类 进程 。 

1) 前 台 进 程 

用 户 当 前 正在 做 的 事情 需要 这 个 进程 。 如 果 满 足下 面 的 条 件 ,进程 即 为 前 台 进 程 。 

CD 这 个 进程 拥有 一 个 正在 与 用 户 交互 的 Activity( 这 个 Activity 的 onResume() 方 法 被 
调用 ) 。 

(2) 这 个 进程 拥有 一 个 绑 定 到 正在 与 用 户 交 互 的 Activity 上 的 Service。 

(3) 这 个 进程 拥有 一 个 前 台 运 行 的 Service. Jf- H3 Service 调用 了 方法 startForegroundO 。 

(4) 这 个 进程 拥有 一 个 正在 执行 其 任何 一 个 生命 周期 回调 方法 (onCreate() ,onStart() 或 
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onDestroy() ) 的 Service。 

(5) 这 个 进程 拥有 正在 执行 其 onReceive() 方 法 的 BroadcastReceiver。 

通常 ,在 任何 时 间 点 ,只 有 很 少 的 前 台 进程 存在 。 一 般 情况 下 ,前 台 进程 不 会 被 * 杀 死 ”, 它 
们 只 有 在 达到 无 法 调和 的 矛盾 时 ,例如 内 存 太 小 而 不 能 继续 运行 时 , 才 会 被 杀 。 通 常 ,到 了 这 
时 ,设备 就 达到 了 一 个 内 存 分 页 调度 状态 ,所 以 需要 杀 一 些 前 台 进程 来 保证 用 户 界 面 的 正常 
反应 。 

2) 可 见 进程 

一 个 进程 不 拥有 运行 于 前 台 的 组 件 ,但 是 依然 能 被 用 户 所 见 。 满 足下 列 条 件 时 ,进程 即 为 
可 见 进程 。 

(1) 这 个 进程 拥有 一 个 不 在 前 台 但 仍 可 见 的 Activity( 它 的 onPause() 方 法 被 调用 )。 例 
如 , 当 一 个 前 台 Activity 启动 一 个 对 话 框 时 ,就 出 现 这 种 情况 。 

(2) 一 个 可 视 的 Activity 所 绑 定 的 Service。 

可 见 进程 被 认为 是 极其 重要 的 。 并 且 ,除非 只 有 杀 掉 它 才 可 以 保证 所 有 前 台 进 程 的 运行 ， 
否则 是 不 能 动 它 的 。 

3) 服务 进程 

满足 下 列 条 件 时 ,进程 即 为 服务 进程 。 

(1) 一 个 由 startService() 方 法 启动 的 Service, 

(2) 支持 正在 处 理 的 不 需要 可 见 界面 运行 的 Service。 

尽管 一 个 服务 进程 不 直接 被 用 户 所 见 , 但 是 它们 通常 做 一 些 用 户 关 心 的 事情 (例如 播放 音 
乐 或 下 载 数据 ) ,所 以 系统 不 到 前 台 进 程 和 可 见 进程 活 不 下 去 时 不 会 杀 它 。 

4) 后 台 进 程 

满足 下 列 条 件 时 ,进程 即 为 服务 进程 。 

COD. 一 个 进程 拥有 一 个 当前 不 可 见 的 Activity(Activity 的 onStop() 方 法 被 调用 ) 。 

(2) 目前 没有 服务 的 Service, 

这 样 的 进程 不 会 直接 影响 到 用 户 体验 ,所 以 系统 可 以 在 任意 时 刻 杀 掉 它们 从 而 为 前 台 T 
见 以 及 服务 进程 们 提供 存储 空间 。 通 常 有 很 多 后 台 进 程 在 运行 。 它 们 被 保存 在 一 个 LRU( 最 
近 最 少 使 用 ) 列 表 中 ,Android 将 会 使 用 last-seen-first-killed 模式 “ 杀 死 ”进程 来 为 前 台 进 程 、 
可 见 进程 和 服务 进程 获得 资源 。 如 果 一 个 Activity 正确 地 实现 了 它 的 生命 周期 方法 ,并 保存 
了 它 的 当前 状态 ,那么 杀 死 它 的 进程 将 不 会 对 用 户 的 可 视 化 体验 造成 影响 。 因 为 当 用 户 返 回 
到 这 个 Activity 时 ,这 个 Activity 会 恢复 它 所 有 的 可 见 状态 。 

5) 空 进程 

空 进程 不 拥有 任何 Active 组 件 , 对 用 户 没有 任何 作用 。 

为 了 改善 系统 的 整体 性 能 ，Android 通常 在 内 存 中 保留 生命 周期 结束 了 的 应 用 。 保 留 这 
类 进程 的 唯一 理由 是 高 速 缓存 ,这 样 可 以 提高 下 一 次 一 个 组 件 要 运行 它 时 的 启动 速度 。 通 常 
根据 进程 高 速 缓存 和 底层 的 内 核 高 速 缓 存 之 间 的 整体 系统 资源 的 需要 而 杀 死 它们 。 


2. 进程 作用 


在 Android 操作 系统 中 ,进程 完全 是 应 用 程序 的 具体 实现 ,不 是 用 户 通常 认为 的 那 种 东 
西 。 它 们 的 主要 用 途 是 简单 的 。 
(1) 改善 稳定 性 或 者 安全 性 ,通过 把 未 信任 或 者 不 稳定 的 代码 放 入 独立 的 进程 的 方法 来 
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解决 。 

(2) 简化 在 同一 进程 中 多 个 . apk 文件 的 代码 的 运行 。 

(3) 有 助 于 系统 管理 资源 ,通过 把 重量 级 代码 放 入 独立 的 进程 ,可 以 被 杀 掉 ,而 且 和 程序 
的 其 他 部 分 无 关 。 


问 一 下 : 

什么 是 .apk 文件 ? 

APK 是 AndroidPackage 的 缩写 , 即 Android 安装 包 , 它 也 是 发 布 应 用 程序 的 文件 , 当 用 
户 在 其 设备 上 安装 应 用 程序 时 ,由 用 户 下 载 这 个 文件 。APK 类 似 Windows 的 exe 文件 ,每 个 
要 安装 到 Android 平台 的 应 用 都 要 被 编译 打包 为 一 个 单独 的 文件 ,后 缓 名 为 . apk。 通 过 将 
APK 文件 直接 传 到 Android 模拟 器 或 Android 手机 中 执行 即 可 安装 。 

APK 文件 是 由 Eclipse 编译 生成 的 文件 包 , 其 中 包含 应 用 程序 的 二 进 制 代码 、 资 源 、 配 置 
文件 等 。APK 文件 其 实 是 zip 格式 ,但 其 后 组 名 被 修改 为 apk。 通 过 WinRAR 或 UnZip 解压 
后 ,可 以 看 到 Dex 文件 。Dex 是 Dalvik VM executes 的 简称 , 即 Android Dalvik 执行 程序 ; 
Resources. arsc 文件 , 即 编译 后 的 二 进 制 资源 文件 ; AndroidManifest. xml 配置 清单 文件 ; 
META-INF 目录 ,该 目录 下 存放 的 是 签名 信息 ; 等 等 。 


3.2.8 线程 


每 个 进程 有 一 到 多 个 线程 运行 在 其 中 。 在 多 数 情况 下 ,系统 不 会 为 进程 中 的 每 一 个 组 件 
启动 一 个 新 的 线程 ,进程 中 的 所 有 组 件 都 在 UI 线程 中 实例 化 ,保证 应 用 程序 是 单线 程 的 , 除 
非 应 用 程序 自己 又 创建 了 线程 。 例 如 ,用 户 界 面 需要 很 快 对 用 户 进行 响应 ,因此 某 些 费时 的 操 
作 , 例 如 网 络 连 接 、 下 载 或 者 非常 占用 服务 器 时 间 的 操作 应 该 放 到 其 他 线程 中 。 

线程 通过 Java 的 标准 对 象 Thread 创建 。Android 提供 了 很 多 方便 的 管理 线程 的 方法 ， 
如 Looper 在 线程 中 运行 一 个 消息 循环 ; Handler 传递 一 个 消息 ; HandlerThread 创建 一 个 带 
有 消息 循环 的 线程 ,等 等 。 

Xt: 

CD 不 要 阻塞 UI 线程。 如 果 在 UI 线程 中 执行 阻塞 或 者 耗 时 操作 会 导致 UI 线程 无 法 响 
应 用 户 请 求 。 

(2) 不 能 在 非 UI 线程 (也 称 为 工作 线程 ) 中 更 新 UI。 这 是 因为 Android 的 UI 控件 都 是 
线程 不 安全 的 。 

由 上 所 述 , 开 发 者 经 常会 启动 工作 线程 完成 耗 时 操作 或 阻塞 操作 ,如 果 需 要 在 工作 线程 的 
执行 期 间 更 新 UI 状态 , 则 应 该 通知 UT 线程 来 进行 。 

编写 Android 平台 的 基本 应 用 程序 和 编写 桌面 应 用 程序 的 难度 ,两 者 并 没什么 不 同 。 甚 
至 因为 Android 平台 拥有 开放 ,免费 、 跨 平台 的 开发 工具 ,使 得 Android 平台 应 用 程序 的 开发 
更 为 单纯 。 

但 是 请 别 忘 了 ,Android 平台 也 是 个 手机 操作 系统 。 撤 掉 其 他 功能 不 谈 , 手 机 的 特性 就 是 
应 该 能 够 随时 在 未 完成 目前 动作 的 时 候 , 离 开 正在 使 用 的 功能 ,切换 到 接 电话 ,接收 简讯 模式 ， 
而 且 在 接 完 电话 回来 应 用 程序 时 .还 希望 能 看 到 离开 时 的 内 容 。 这 就 是 所 谓 的 多 任务 (Multi- 
Task) 的 操作 系统 。 同 时 执行 多 个 程序 有 它 的 明显 好 处 ,但 是 也 有 它 的 严重 缺点 。 每 多 执行 
一 个 应 用 程序 ,就 会 多 耗费 一 些 系统 内 存 , 而 手机 里 的 内 存 是 相当 有 限 的 。 当 同时 执行 的 程序 
过 多 ,或 是 关闭 的 程序 没有 正确 释放 掉 内 存 ,执行 系 统 时 就 会 觉得 越 来 越 慢 ,甚至 不 稳定 。 为 
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了 解决 这 个 问题 Android 引入 了 一 个 新 的 机 制 一 一 生命 周期 (Life Cycle), 


6.3 Android 应 用 程序 生命 周期 


应 用 程序 进程 从 创建 到 结束 的 全 过 程 就 是 应 用 程序 的 生命 周期 。 与 其 他 系统 不 同 的 是 ， 
Android 应 用 程序 的 生命 周期 是 由 Android 框架 进行 管理 ,而 不 是 由 应 用 程序 直接 控制 。 一 
般 情况 下 ,Android 系统 会 根据 应 用 程序 对 用 户 的 重要 性 和 当前 系统 的 负载 来 决定 生命 周期 
的 长 短 。 

对 于 应 用 开发 者 来 说 ,理解 不 同 的 应 用 组 件 (特别 是 Activity, Service, Intent 和 Receiver) 
对 应 用 进程 的 生命 周期 的 影响 ,这 是 非常 重要 的 。 如 果 没 有 正确 地 使 用 这 些 组 件 , 将 会 导致 当 
应 用 正在 处 理 重要 的 工作 时 ,进程 却 被 系统 销毁 的 后 果 。 

应 用 程序 组 件 有 其 生命 周期 : 由 Android 初始 化 它们 ,以 响应 Intent 响应 意图 ,直到 结 
束 , 实 例 被 销毁 。 在 这 期 间 , 它 们 有 时 候 处 于 激活 状态 ,有 时 候 处 于 非 激活 状态 ; 对 于 Activity 
(活动 ) 而 言 , 用 户 有 时 候 可 见 , 有 时 候 不 可 见 。Activity 类 是 Android 应 用 生命 周期 的 重要 部 
分 之 一 ,本 节 主 要 讨论 Activity 的 生命 周期 及 它们 可 能 的 状态 。 


3.3.1 Activity 的 生命 周期 


在 系统 中 的 Activity 被 一 个 Activity 栈 所 管理 。 当 一 个 新 的 Activity 启动 时 ,将 被 放置 
到 栈 顶 , 成 为 运行 中 的 Activity. 前 一 个 Activity 保留 在 栈 中 ,不 再 放 到 前 台 , 直到 新 的 
Activity 退出 为 止 。 从 启动 到 退出 ,Activity 经 历 了 一 个 生命 周期 。 


1. Activity 生命 周期 的 状态 


Activity 生命 周期 中 存在 5 种 状态 : 启动 ,运行 ,暂停 ,停止 ,销毁 。 

当 Activity 被 压 人 栈 顶 ,在 屏幕 的 前 台 , 称 为 启动 状态 (Starting)。 此 时 ,Activity 可 见 并 
获得 焦点 ,与 用 户 进行 交互 , 称 为 运行 状态 (Running)。 一 般 地 , 当 一 个 Activity 启动 后 随即 
处 于 运行 状态 。 

如 果 一 个 Activity 失去 焦点 ,但 是 依然 可 见 , 例 如 一 个 新 的 非 全 屏 的 Activity 或 者 一 个 透 
明 的 Activity 被 放置 在 栈 顶 时 , 称 为 暂停 状态 (Paused) 。 一 个 暂停 状态 的 Activity 依然 保持 
活力 ,如 保持 所 有 的 状态 ` 成 员 信息 和 窗口 管理 器 保持 连接 等 。 但 是 在 系统 内 存 极端 低下 的 时 
候 将 被 杀 掉 。 

如 果 一 个 Activity 被 另外 的 Activity 完全 覆盖 掉 , 称 为 停止 状态 (Stopped)。 它 依然 保持 
所 有 状态 和 成 员 信息 ,但 是 它 不 再 可 见 , 所 以 它 的 窗口 被 隐藏 。 当 系统 内 存 需 要 被 用 在 其 他 地 
方 的 时 候 ,Stopped 的 Activity 将 被 杀 掉 。 

如 果 一 个 Activity 是 Paused 或 者 Stopped 状态 ,系统 可 以 将 该 Activity 从 内 存 中 删除 ， 
称 为 销毁 状态 (Destroyed) 。Android 系统 采用 两 种 方式 进行 删除 ,要 么 要 求 该 Activity 结束 ， 
要 么 直接 杀 掉 它 的 进程 。 当 该 Activity 再 次 显示 给 用 户 时 , 它 必 须 重 新 开始 和 重 置 前 面 的 


2. Activity 生命 周期 的 状态 转变 
Activity 在 其 生命 周期 中 ,上 述 几 种 状态 可 以 通过 操作 事件 或 内 部 控制 机 制 进行 相互 转 
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变 ,具体 的 状态 转变 以 及 触发 事件 如 图 3-1 所 示 。 


1 

c dd ACIE 
3 PEE 

其 他 情况 实例 启动 / 


图 3-1. Activity 的 状态 转变 


3.3.2 Activity 生命 周期 中 的 方法 


在 前 面 ,我 们 发 现 所 有 继承 自 Activity 的 类 都 重 写 了 onCreate( ) 方 法 ,程序 运行 就 会 自动 
进入 这 个 方法 。 其 实 Activity 类 中 还 有 很 多 类 似 于 onCreate() 的 方法 ,例如 onStart O, 
onResume() ,onPauseO .onDestroy() 等 ,而 这 些 方法 都 是 系统 自动 调用 。 

当 一 个 Activity 从 一 个 状态 转变 为 另 一 个 状态 时 , Activity 被 这 些 方法 所 通知 。 我 们 可 
以 重 写 所 有 这 些 方 法 以 在 Activity 状态 改变 时 进行 合适 的 工作 。 所 有 的 Activity 都 必须 实现 
onCreate() 用 以 当 对 象 第 一 次 实例 化 时 进行 初始 化 设置 。 在 实际 开发 中 ,很 多 时 候 Activity 
需要 重 写 onPauseO ,以 提交 数据 变化 或 准备 停止 与 用 户 的 交互 。 

在 Activity 的 整个 生命 周期 中 有 9 种 方法 。 表 3-2 对 每 个 方法 进行 了 详细 的 描述 以 及 在 
Activity 的 整个 生命 周期 中 的 定位 。 


表 3-2 生命 周期 方法 说 明 


5 È 描 xk pa Tt 


在 Activity 第 一 次 被 创建 的 时 候 调用 。 这 里 是 做 所 有 初 
始 化 设置 的 地 方 ,如 创建 视图 、. 绑 定数 据 至 列表 等 。 如 
onCreate() 果 曾 经 有 状态 记录 , 则 调用 此 方法 时 会 传人 一 个 包含 着 f onStart() 
此 Activity 以 前 状态 的 Bundle 对 象 作为 参数 。 
紧 跟 其 后 的 方法 总 是 onStartO 


ida 在 Activity 停止 后 ,在 再 次 启动 之 前 被 调用 。 S |onStatO 


紧 跟 其 后 的 方法 总 是 onStart() 


当 Activity 变 为 用 户 可 见 之 前 被 调用 。 
onStart() X Activity 转向 前 台 时 接 下 来 调用 onResume() ,在 否 
Activity 变 为 隐藏 时 接 下 来 调用 onStop() 


onResume() 或 


onStop() 


在 Activity 开始 与 用 户 进行 交互 之 前 被 调用 。 此 时 
onResume() Activity 位 于 堆栈 顶部 ,并 接受 用 户 输入 。 否 onPause() 
紧 跟 其 后 的 方法 是 onPause() 
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续 表 
5 È 描 述 TE 下 三 个 
当 系 统 将 要 启动 男 一 个 Activity 时 调用 。 此 方法 主要 用 
来 将 未 保存 的 变化 进行 持久 化 ,停止 动画 和 其 他 耗费 
et CPU 的 动作 等 。 这 一 切 动作 应 该 在 短 时 间 内 完成 ,因为 是 onResume() 或 
下 一 个 Activity 必须 等 到 此 方法 返回 后 才 会 继续 。 onStop() 
当 Activity 重新 回 到 前 台 时 接 下 来 调用 onResume()。 
当 Activity 变 为 用 户 不 可 见 时 接 下 来 调用 onStop() 
当 Activity 不 再 为 用 户 可 见 时 调用 此 方法 。 这 可 能 发 生 
在 它 被 销毁 或 者 另 一 个 Activity( 可 能 是 现存 的 或 者 是 
onStopO 新 的 ) 回 到 运行 状态 并 覆盖 了 它 。 是 
如 果 Activity 再 次 回 到 前 台 与 用 户 交互 则 接 下 来 调用 
onRestart() ,如 果 关 闭 Activity 则 接 下 来 调用 onDestroy() 
在 Activity 销毁 前 调用 。 这 是 Activity 接收 的 最 后 一 个 
调用 。 这 可 能 发 生 在 Activity 结束 (调用 了 它 的 finish() 
onDestroy() 方法 ) 或 者 因为 系统 需要 空间 所 以 临时 销毁 了 此 是 nothing 
Acitivity 的 实例 时 。 可 以 通过 isFinishing() 方法 来 区 
分 这 两 种 情况 
调用 该 方法 让 Activity 可 以 保存 每 个 实例 的 状态 。 
onSavelInstanceState 当 Activity 由 运行 状态 变 为 可 见 时 接 下 来 调用 onPauseO , onPause() 或 
(Bundle) 当 Activity 由 暂停 状态 变 为 可 见 停止 状态 时 接 下 来 调用 onStop() 
onStop() 
使 用 onSaveInstanceState() 方 法 保存 的 状态 来 重新 初始 
化 某 个 Activity 时 调用 该 方法 。 onResume() 
紧 跟 其 后 的 方法 是 onResume() 


onRestart() 或 
onDestroy() 


onRestoreInstanceState 


(Bundle) 


这 9 个 方法 定义 了 Activity 的 整个 生命 周期 。 有 三 个 嵌 套 的 循环 ,用 户 可 以 通过 这 9 个 
方法 监视 以 下 内 容 。 

CD. Activity 的 整个 生命 时 间 。 

从 第 一 次 调用 onCreate() 开 始 直 到 调用 onDestroy() 结 束 。 一 个 Activity 在 onCreate() 
中 做 所 有 的 “全 局 ”状态 的 初始 设置 ,在 onDestroy() 中 释放 所 有 保留 的 资源 。 举 例 来 说 ,有 一 
个 线程 运行 在 后 台 从 网 络 上 下 载 数据 , 它 可 能 会 在 onCreate() 中 创建 线程 ,在 onDestroy() 中 
结束 线程 。 

(2) Activity 的 可 视 生 命 时 间 。 

从 调用 onStart() 到 相应 的 调用 onStop()。 在 这 期 间 , 用 户 可 以 在 屏幕 上 看 见 Activity， 
虽然 它 可 能 不 是 运行 在 前 台 且 与 用 户 交互 。 在 这 两 个 方法 之 间 , 可 以 保持 显示 Activity 所 需 
要 的 资源 。 举 例 来 说 ,可 以 在 onStart() 中 注册 一 个 广播 接收 者 监视 影响 你 的 UI 的 改变 ,在 
onStop() 中 注销 。 因 为 Activity 在 可 视 和 隐藏 之 间 来 回 切 换 ,onStart() 和 onStop() 可 以 调用 
多 次 。 

(3) Activity 的 前 台 生命 时 间 。 

从 调用 onResume() 到 相应 的 调用 onPause()。 在 这 期 间 , 频 繁 地 在 重用 和 和 暂停 状态 转 
换 。 例 如 , 当 设 备 进入 睡眠 状态 或 一 个 新 的 Activity 启动 时 调用 onPause() , 当 一 个 Activity 
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返回 或 一 个 新 的 Intent 被 传输 时 调用 onResume()。 因 此 ,这 两 个 方法 的 代码 应 当 是 相当 轻 
量 级 的 。 

图 3-2 解释 了 这 三 个 循环 和 状态 之 间 状 态 的 可 能 路 径 , 其 中 标注 了 “* ”号 的 为 可 选项 ,从 
一 个 状态 到 另 一 个 状态 之 间 , 用 (1)、(2)、(3) 表 示 调 用 方法 的 先后 顺序 。 


(1) onCreate() 

(2) onStart() 

(3) onRestoreInstanceState()* 
(4) onResume() 


(1) onSaveInstanceState()* 


3) onR 
(3) onResume() (2) onPause() 


(2) onStart() 


(1) onRestart() 
onResume() 


Stopped 


onDestroy() 


(1) onSaveInstanceState()* 
(2) onStop() 


or «Process killed» 
«Process killed» 


3-2. 在 生命 周期 中 成 员 方法 的 调用 时 机 


多 个 Activity 生命 周期 中 方法 的 调用 过 程 举例 。 如 果 有 两 个 Activity 分 别 为 Activity 
A. Activity B, 依 次 进行 下 列 操作 ,Android 的 生命 周期 方法 调用 的 情况 如 下 。 

CD 先 启 动 第 一 个 界面 Activity A. 方 法 回调 的 次 序 是 : 

onCreate(A) 一 onStart(A) 一 onResume(A) 

(2) 如 果 Activity A 不 关闭 , 跳 转 第 二 个 Activity B, 方 法 回调 的 次 序 是 ， 

onFreeze( A)—>onPause( A)—>onCreate(B)—> onStart(B) 一 onResume(B) 一 onStop(A) 

(3) 如 果 按 Back 键 后 , 回 到 第 一 个 界面 ,这 时 方法 回调 的 次 序 是 : 

onPause( B)-*ÁonActivityforResult A) onRestart (A)  onStart (A)  onResume(C A) — 
onStop( B) onDestroy (B) 

(4) 如 果 单 击 Exit 退出 应 用 时 ,方法 回调 的 次 序 是 : 

onPause(A) 一 onStop(A) 一 onDestroy(A) 


6.4 Android 组 件 间 的 通信 


在 2.3 节 中 已 知道 , Intent 是 连接 应 用 程序 的 三 个 核心 组 件 一 一 Activity、Service 和 
BroadcastReceiver 的 桥梁 ,可 想 而 知 ,Intent 把 握 着 Android 各 组 件 间 的 通信 。 

刚 接触 Intent 的 时 候 , 大 多 数 人 都 会 有 点 困惑 : 从 字面 上 来 说 , 它 表 示 一 种 意图 和 目的 ; 
从 使 用 上 看 , 它 似乎 总 是 用 于 Activity 之 间 的 切换 ; 而 从 它 所 在 包 android. content 来 看 , 它 
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似乎 与 内 容 有 关 。 所 以 可 以 这 样 来 理解 它 : Intent 类 绑 定 一 次 操作 , 它 负 责 携带 这 次 操作 所 
需要 的 数据 以 及 操作 的 类 型 等 。 

Intent 本 身 是 一 个 Intent 类 对 象 , Intent 类 都 定义 在 android. content. Intent 中 ,所 以 在 
使 用 它 之 前 需要 在 代码 文件 的 前 部 加 上 “import android. content. Intent;”。 每 个 Intent 对 象 
是 由 一 个 包含 被 执行 操作 抽象 描述 的 被 动 的 数据 结构 ,或 者 对 于 广播 而 言 , 是 某 件 已 经 发 生 并 
被 声明 的 事情 的 描述 。 

Intent 存在 不 同 的 机 制 来 传送 Intent 到 每 种 组 件 中 。 

(1) 一 个 Intent 对 象 通过 调用 Context. startActivity() 或 者 Activity. startActivityForResult() 
来 启动 一 个 Activity 或 者 让 一 个 存在 的 Activity 去 做 某 些 新 的 事情 。 

(2) 一 个 Intent 对 象 通过 调用 Context. startService() 来 发 起 一 个 Service 或 者 递交 新 的 
指令 给 运行 中 的 Service。 类 似 地 ,一 个 Intent 对 象 通过 Context. bindService() 来 在 调用 组 件 
和 一 个 目标 Service 之 间 建 立 连接 。 作 为 一 个 可 选项 ,如 果 一 个 Service 还 没 运行 它 可 以 发 
起 之 。 

(3) 一 个 Intent 对 象 通过 调用 Context. sendBroadcast() , Context. sendOrderedBroadcast( ) 或 
者 Context, sendStickyBroadcast() 传 递 给 所 有 感 兴趣 的 BroadcastReceiver。 许 多 种 广播 产生 
于 系统 代码 。 

这 样 ,Android 系统 会 找到 合适 的 Activity, Service 或 BroadcastReceiver 来 回应 这 个 
Intent, 必 要 时 实例 化 它们 。 这 些 消息 传送 系统 没有 重 麦 : 一 个 传送 给 startActivity O 的 
Intent 是 只 会 被 传递 给 一 个 Activity, 永 远 不 会 给 一 个 Service 或 广播 接收 者 ,广播 意图 仅 被 传 
递 给 BroadcastReceiver, 永 远 不 会 给 Activity 或 者 Service, 以 此 类 推 。 


3.4.1 Intent 对 象 


一 个 Intent 对 象 (Intent Objects) 其 实 就 是 一 堆 信 息 的 捆绑 。 它 包含 接收 这 个 Intent 的 
组 件 感 兴趣 的 信息 ,例如 将 要 采取 的 动作 和 操作 的 数据 ,再 加 上 Android 系统 感 兴趣 的 信息 ， 
例如 应 该 处 理 这 个 Intent 的 组 件 类 别 和 如 何 启动 一 个 目标 Activity 的 指令 。Intent 对 象 由 组 
IFZ FR, Action, Data, Category, Extra 及 Flag 6 部 分 组 成 。 下 面 分 别 给 予 描述 。 


1. 组 件 名 称 


组 件 名 称 (Component name) 是 要 处 理 这 个 Intent 的 组 件 的 名 字 。 组 件 名 字 是 可 选 的 。 
如 果 被 设置 了 ,这 个 Intent 对 象 将 被 传递 到 指定 的 类 。 如 果 没 有 设置 , 则 在 Androidmanifest. 
xml 中 ,通过 使 用 IntentFilter 来 找 与 该 Intent 最 合适 的 组 件 。 

组 件 名 字 通 过 方法 setComponent() ,setClass() 或 者 setClassName() 来 设置 ,通过 方法 
getComponent() 来 读 取 。 


2. 动作 


动作 (Action) 是 一 个 将 被 执行 的 动作 的 字符 串 命 名 ,或 者 ,对 于 广播 意图 而 言 ,是 发 生 并 
被 报告 的 动作 。 这 个 Intent 类 定义 了 一 些 动作 常量 ,用 大 写 英文 单词 和 下 划 线 组 成 ,如 表 3-3 
所 示 。 
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表 3-3 常用 的 动作 常量 说 明 


常 E 目标 组 件 动作 含义 
ACTION_CALL Activity 拨打 电话 ,被 呼叫 的 联系 人 在 数据 中 指定 
ACTION_EDIT Activity 显示 数据 给 用 户 进行 编辑 
ACTION_GET_CONTENT Activity 让 用 户 选择 数据 并 返回 
ACTION_INSERT Activity 在 容器 中 插入 一 个 空 项 
ACTION_MAIN Activity 启动 一 个 任务 的 起 始 Activity, 没 有 数据 输入 
和 数据 返回 

ACTION_PICK Activity 从 数据 中 选择 一 个 子 项 目 , 并 返回 所 选中 的 
项 目 

ACTION_BATTERY_LOW BroadcastReceiver ”提示 电池 电量 低 

ACTION_SCREEN_ON BroadcastReceiver ”屏幕 已 开启 

ACTION HEADSET PLUG BroadcastReceiver ”耳机 插 拔 


ACTION _TIMEZONE_CHANGED  .fBroadcastReceiver ”时 区 变化 


动作 很 大 程度 上 决定 了 Intent 其 他 部 分 如 何 被 组 织 , 尤 其 是 数据 data 和 附加 字段 
extras。 这 就 好 比 一 个 方法 名 决定 了 一 些 参数 和 返回 值 一 样 。 因 此 ,在 实际 开发 中 要 尽 可 能 
地 把 具体 的 动作 名 与 Intent 的 其 他 字段 紧密 联系 起 来 。 换 名 话说 ,要 为 组 件 能 处 理 的 Intent 
对 象 定义 一 个 整体 的 协议 ,而 不 是 定义 一 个 孤立 的 动作 。 

开发 者 可 以 定义 自己 的 动作 ,并 定义 相应 的 Activity 来 处 理 自 定义 动作 。 一 个 Intent 对 
象 里 的 动作 可 以 通过 setAction() 方 法 来 设置 ,通过 getAction() 方 法 来 读 取 。 


3. 数据 


数据 (Data) 是 为 动作 提供 要 操作 的 信息 ,用 指向 数据 的 一 个 资源 标识 符 (URD 来 表示 。 
不 同 的 动作 伴随 着 不 同 种 类 的 数据 规格 。 例 如 ,如 果 动 作 是 ACTION_EDIT, 数 据 字 段 会 包 
含 可 编辑 文档 的 URI; 如 果 动 作 是 ACTION_CALL, 数 据 字段 会 是 一 个 含 呼叫 电话 号 码 的 
URI。 当 匹配 一 个 Intent 到 一 个 能 处 理 数据 的 组 件 时 ,除了 它 的 URI 外 ,通常 需要 知道 数据 
类 型 ( 即 多 用 途 互联 网 邮件 扩展 ,MIME) 。 

从 2.3 节 已 经 知道 ,URI 的 格式 为 “scheme://host:port/path”。 在 很 多 情况 下 ,这 个 数 
据 类 型 可 以 从 URI 里 推断 出 来 。 尤 其 是 当 scheme 的 内 容 为 *content” 时 ,这 意味 着 数据 被 存 
放 在 设备 上 而 且 由 一 个 内 容 提 供 器 控制 着 。 

例如 ,指向 1 号 联系 人 的 URI 为 : content://contacts/1, 在 Java 代码 中 ,获取 一 个 URI 
的 语句 格式 为 : 


Uri uri = Uri.parse(c f fff»); 

创建 一 个 Intent 对 象 的 语句 格式 为 : 
Intent intent = new Intent(< 动 作 >, < 内 容 >); 
代码 : 


Uri uril = Uri.parse("content://contacts/1"); 
Intent intent = new Intent(Intent. ACTION VIEW, uril); 


“uril” 是 一 个 URI 变量 ,其 值 是 “content://contacts/1”, 它 指向 设备 上 (如 手机 ) 的 联系 
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人 信息 集中 的 第 一 个 联系 人 。 新 创建 的 Intent 对 象 intent 包含 的 信息 是 显示 标识 符 为 “1” 的 
联系 人 的 详细 信息 。 

代码 : 

Uri uri = Uri.parse("content://contacts/"); 

Intent intent = new Intent(Intent. ACTION PICK, uri); 

“uri” 是 一 个 URI 变量 ,其 值 是 “content://contacts/”, 它 指向 设备 上 (如 手机 ) 的 所 有 联 
系 人 。 新 创建 的 Intent 对 象 intent 包含 的 信息 是 显示 所 有 联系 人 的 列表 ,并 返回 选择 的 联系 
人 信息 。 

通过 setData() 方 法 指定 数据 只 能 为 一 个 URI, 通 过 setType() 方 法 指定 数据 只 能 是 一 个 
MIME 类 型 ,而 通过 setDataAndType() 方 法 可 同时 指定 数据 为 URI 和 MIME。 通 过 getData() 方 
法 来 读 取 URI, 通 过 getType() 方 法 来 读 取 类 型 。 


4. 类别 


类 别 (Category) 是 关于 Intent 中 action 要 执行 的 动作 的 附加 描述 , 它 是 一 个 字符 串 。 可 
以 把 任意 数目 的 类 别 描述 放 到 一 个 Intent 对 象 里 。 和 动作 一 样 ,Intent 类 别 定义 了 若干 类 别 
常量 ,如 表 3-4 所 示 。 


表 3-4 常用 的 类 别 常量 说 明 


常 E *& x 
CATEGORY ALTERNATIVE ”在 某 种 数据 类 型 的 项 目 上 可 以 替代 默认 执行 的 动作 。 例 如 ,一 个 联系 
人 的 默认 动作 是 浏览 它 ,替代 的 可 能 是 去 编辑 或 删除 它 
CATEGORY_BROWSABLE 目标 Activity 可 以 被 浏览 器 安全 地 唤起 来 显示 被 一 个 链接 所 引用 的 数 
据 。 例 如 ,一 张 图 片 或 一 条 E-mail 消息 


CATEGORY DEFAULT 设置 这 个 类 别 来 让 组 件 成 为 Intent 过 滤器 中 定义 的 data 的 默认 动作 。 
这 对 使 用 显 式 Intent 启动 的 Activity 来 说 也 是 必要 的 

CATEGORY_HOME 这 个 Activity 将 显示 桌面 ,也 就 是 用 户 开机 后 看 到 的 第 一 个 屏幕 或 者 按 
HOME 键 时 看 到 的 屏幕 

CATEGORY LAUNCHER 这 个 Activity 可 以 是 一 个 任务 的 初始 Activity, 并 被 列 在 应 用 程序 启动 
器 的 顶层 


CATEGORY_PREFERENCE 目标 Activity 是 一 个 选择 面板 


通过 addCategory() 方 法 在 一 个 Intent 对 象 中 添加 一 个 类 别 ,通过 removeCategory() 方 
法 删除 之 前 添加 的 类 别 ,通过 getCategories( ) 方 法 可 以 获取 当前 对 象 的 所 有 类 别 。 


5. 附加 信息 


附加 信息 (Extra) 是 要 递交 给 Intent 处 理 组 件 的 附加 信息 键 - 值 对 。 就 像 一 些 动作 伴随 着 
特定 的 数据 URIS 类 型 一 样 .一 些 动作 也 要 伴随 着 特定 的 附加 信息 。 例 如 ,一 个 TIMEZONE_ 
CHANGED ACTIONIntent 有 一 个 “时 区 ”附加 信息 用 来 区 别 新 的 时 区 ,而 HEADSET _ 
PLUG ACTION 有 一 个 “状态 ”附加 字段 表明 耳机 有 没有 插 着 ,以 及 一 个 “名 字 ” 附 加 信息 来 
表示 耳机 的 类 型 。 如 果 想 要 创建 一 个 SHOW_COLOR 动作 ,颜色 的 值 将 被 设置 在 一 个 附加 
的 键 - 值 对 中 。 

Intent 对 象 有 一 系列 的 put...0 〇 方法 来 插入 各 种 不 同 的 附加 数据 ,同样 ,有 一 系列 的 get...() 
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方法 来 读 取 数 据 。 这 些 方法 与 Bundle 对 象 的 方法 相似 。 事实 上 ,附加 信息 就 是 可 以 被 当 作 一 
个 Bundle 对 象 ,通过 使 用 putExtras() 和 getExtras() 方 法 来 插入 和 读 取 。 


6. 标志 


标志 (Flag) 是 各 种 类 型 的 标志 。 许 多 标志 用 来 指示 Android 系统 如 何 去 加 载 一 个 
Activity( 例 如 ,哪个 是 这 个 Activity 应 该 归属 的 任务 ) 和 启动 后 如 何 对 待 它 ( 例 如 , 它 是 否 属于 
当前 Activity 列表 ) ,所 有 这 些 列表 都 在 Intent 类 中 定义 了 。 

Intent 可 以 分 成 两 大 类 ,一 类 是 显 式 意图 (Explicit Intent) , 另 一 类 是 隐 式 意图 (Implicit 
Intent) 。 

显 式 意图 , 即 指定 了 组 件 名 称 , 通 过 名 字 指 明 目 标 组 件 。 一 般 地 ,组 件 名 称 通常 不 为 其 他 
应 用 程序 的 开发 者 所 了 解 , 显 式 意图 常 被 用 作 应 用 程序 的 内 部 消息 ,例如 一 个 Activity 启动 一 
个 附属 Service 或 姊妹 Activity. 

隐 式 意图 , 即 不 指定 组 件 名 称 。 隐 式 意 图 经 常用 来 激活 其 他 应 用 程序 的 组 件 。 

Android 递交 一 个 显 式 的 Intent 给 一 个 指定 目标 类 的 实例 。Intent 对 象 中 的 组 件 名 称 叭 
一 地 确定 哪个 组 件 应 该 获取 这 个 Intent。 隐 式 Intent 则 需要 一 个 不 同 的 策略 。 在 没有 指定 目 
标 组 件 的 情况 下 ,Android 系统 必须 找到 最 合适 的 组 件 来 处 理 这 个 Intent, 这 就 需要 用 到 意图 
过 滤器 (Intent filters) 了 。 


3.4.2 Intent 过 滤器 


为 了 通知 系统 它们 可 以 处 理 哪些 Intent, Activity, Service 和 BroadcastReceiver 可 以 有 一 
个 或 多 个 意图 过 滤器 。 每 个 过 滤器 描述 组 件 的 一 个 能 力 , 一 系列 组 件 想 要 接收 的 Intent。 它 
实际 上 按照 一 个 期 望 的 类 型 来 进行 Intent 滤 入 ,同时 滤 出 不 想 要 的 Intent。 要 提醒 读者 注意 
的 是 ,意图 过 滤器 只 针对 隐 式 意图 起 作用 。 对 于 一 个 显 式 意 图 , 它 总 能 够 被 递交 给 它 的 目标 组 
件 ,而 无 论 它 包含 什么 。 这 种 情况 下 过 滤器 不 起 作用 。 

在 Android 系统 中 ,可 以 用 Java 代码 来 设置 IntentFilter 类 的 一 个 实例 ,但 是 在 更 多 情况 
下 ,是 使 用 在 应 用 程序 清单 文件 AndroidManifest. xml 中 设置 一 intent-filter 过 标签。 在 其 中 
WERNE WAA, —intent-filter > bi E 7€ UA — action , — category >, < data ^ ^ 
元 素 。 

3.4.3 Intent 解析 

通过 比较 Intent 对 象 的 内 容 和 意图 过 滤器 ,找到 相 匹 配 的 目标 组 件 。 如 果 一 个 组 件 没有 
任何 的 意图 过 滤器 , 那 它 只 能 接收 显 式 意 图 。 一 个 带 过 滤器 的 组 件 可 以 同时 接收 显 式 和 隐 式 
意图 。 


当 一 个 Intent 对 象 被 一 个 意图 过 滤器 测试 时 ,一 般 是 通过 对 动作 .数据 (URI 和 MIME) 
和 类 别 三 个 方面 进行 监测 的 。 下 面 分 别 进 行 介绍 。 


1. 检查 Action 


一 个 Intent 只 能 设置 一 种 Action .但 是 一 个 IntentFilter 却 可 以 设置 多 个 Action 过 滤 。 
当 IntentFilter 设置 了 多 个 Action 过 滤 时 ,只 需 一 个 满足 即 可 完成 Action 验证 。 如 果 
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IntentFilter 中 没有 声明 任何 一 个 Action, 那 么 任何 的 Action 都 不 能 与 之 匹配 。 如 果 Intent 
中 没有 包含 任何 Action, 那 么 只 要 IntentFilter 中 含有 Action 时 , 便 会 与 之 匹配 成 功 。 


2. 检查 Data 


对 数据 的 监测 主要 包含 两 部 分 ,一 是 对 数据 的 URI 进行 监测 ,二 是 对 数据 的 类 型 进行 监 
测 。 而 数据 的 URI 又 被 分 为 三 部 分 : scheme、authority、path, 只 有 这 些 信息 完全 匹配 时 ,Data 
的 验证 才 会 成 功 。 


3. 检查 Category 


在 IntentFilter 中 同样 可 以 设置 多 个 Category。 当 Intent 中 的 Category 5 IntentFilter 
中 的 一 个 Category 完全 匹配 时 ,此 Category 便 会 验证 通过 ,而 其 他 的 Category 并 不 受 影响 。 
但 是 当 IntentFilter 中 没有 设置 Category 时 ,只 能 与 没有 设置 Category 的 Intent 匹配 。 

一 个 隐 式 意图 为 了 递交 到 拥有 这 个 过 滤器 的 组 件 , 它 必须 通过 以 上 三 项 测试 。 即 使 只 有 
一 个 不 通过 ,Android 系统 都 不 会 把 它 递交 给 这 个 组 件 。 应 该 注意 的 是 ,由 于 一 个 组 件 可 以 包 
含 多 个 意图 过 滤器 ,一 个 Intent 不 能 通过 其 中 一 个 过 滤器 ,但 可 能 在 另外 的 过 滤器 上 获得 
通过 。 

下 面 以 SDK 的 NotePad 范例 为 例 进行 介绍 。 在 自己 的 计算 机 上 找到 NotePad 范例 的 位 
置 ,如 本 书 的 在 E:\android-sdk\samples\android-10\NotePad 中 ,打开 AndroidManifest. xml 
文件 ,阅读 第 一 个 一 activity 之 标签 , 它 声 明了 三 个 过 滤器 ,代码 如 下 。 

1 «activity android:name = "NotesList" 

2 android: label = "(Qstring/title notes list" 

3 < intent - filter > 

4 <action android:name = "android. intent. action. MAIN" /> 

5i < category android:name = "android. intent. category. LAUNCHER" /> 

6 «/ intent - filter» 

7 

8 


< intent - filter > 
X action android:name = "android. intent. action. VIEW" /> 


9 X action android:name = "android. intent. action. EDIT" /> 

10 < action android:name = "android. intent. action. PICK" /> 

it < category android:name = "android. intent. category. DEFAULT" /> 

12 < data android:mimeType - "vnd. android. cursor. dir/vnd. google. note" /> 
13 «/intent - filter» 

14 < intent - filter» 

15 < action android:name = "android. intent. action. GET CONTENT" /> 

16 < category android:name = "android. intent. category. DEFAULT" /> 

17 « data android:mimeType - "vnd. android. cursor. item/vnd. google. note" /» 
18 «/intent - filter» 


19 «/activity» 


CD 第 3—6 行 定 义 第 一 个 过 滤器 ,用 于 声明 名 称 为 “NotesList” 的 Activity 是 本 应 用 程序 
的 起 始 Activity, 并 且 是 被 并 列 在 应 用 程序 启动 器 的 顶层 。 其 中 ,元 素 “<action android: name= 
"android. intent. action. MAIN" /二 ”匹配 Intent 的 动作 常量 “ACTION _ MAIN”; 元 素 
“< 一 category android:name 一 "android. intent. category. LAUNCHER" /二 "匹配 Intent 的 类 
别 常量 "CATEGORY_LAUNCHER”。 

(2) 第 7—13 行 定义 第 二 个 过 滤器 ,用 于 声明 用 户 可 以 查看 、 编 辑 或 选择 的 一 个 指定 的 记 
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事 目 录 。 其 中 ,元 素 “ 一 action android: name =" android. intent. action. VIEW" /二 ”匹配 
Intent 的 动作 常量 *ACTION_ VIEW” ,元素 “二 action android: name= "android. intent, action. 
EDIT " /二 ”匹配 Intent 的 动作 常量 "ACTION_ EDIT” , 76 ££ “< action android; name = 
"android. intent. action, PICK " /二 ”匹配 Intent ff zi fE 7$ 3& * ACTION... PICK”; 75 
“<category android: name- "android. intent. category. DEFAULT" /二 ?匹配 Intent 的 类 别 
W 8"CATEGORY DEFAULT"; 元 素 “ 一 data android: mimeType — " vnd. android. cursor. 
dir/vnd. google. note" /之 ”匹配 Intent 的 数据 的 MIME 类 型 是 “vnd. android. cursor. dir/ 
vnd. google. note", 

(3) 在 NotesList. java 代码 中 ,例如 有 如 下 代码 创建 一 个 Intent 对 象 , 其 中 noteUri 是 存 
放 URI 的 一 个 变量 。 

startActivity(new Intent(Intent. ACTION EDIT, noteUri)); 

(4) 第 14—18 行 定义 第 三 个 过 滤器 ,用 于 声明 在 没有 初始 目录 说 明 的 情况 下 查找 一 个 特 
定 的 记录 。 其 中 ,元 素 “ 一 action android: name — "android. intent. action. GET. CONTENT" />” 
匹配 Intent 的 动作 常量 *ACTION_ GET_CONTENT”。 

在 第 二 个 二 activity 之 标签 中 , 它 声明 了 三 个 过 滤器 ,代码 如 下 。 


1 «activity android:name = "NoteEditor" 

2 android: theme = "(d)android:style/Thenme. Light" 

3 android:configChanges = "keyboardHidden|orientation"> 

4 <! -- This filter says that we can view or edit the data of 

5 a single note -一 > 

6 < intent ~ filter android: label = "(Qstring/resolve edit"» 

7 X action android:name = "android. intent. action. VIEW" /> 

8 «action android:name = "android. intent. action. EDIT" /> 

9 « action android:name = "com. android. notes. action. EDIT NOTE" /> 

10 < category android:name = "android. intent. category. DEFAULT" /> 

11 < data android:mimeType = "vnd. android. cursor. item/vnd. google. note" /> 
12 «/intent - filter» 

13 

14 <! —— This filter says that we can create a new note inside 

15 of a directory of notes. --> 

16 < intent - filter» 

17 < action android:name = "android. intent. action. INSERT" /> 

18 < category android:name = "android. intent. category. DEFAULT" /» 

19 < data android:mimeType = "vnd. android. cursor. dir/vnd. google. note" /> 
20 «/intent - filter» 


21 «/activity» 


(1) 第 6 一 12 行 定义 第 一 个 过 滤器 ,用 于 声明 用 户 可 以 在 一 个 便签 页 中 浏览 或 编辑 其 中 
的 数据 。 其 中 ,元素 “一 action android: name— " com. android. notes. action. EDIT NOTE" /二 ”是 
用 户 自 定义 的 动作 。 
(2) 在 NoteEditor. java 代码 中 ,有 如 下 代码 创建 一 个 自 定义 的 动作 ,其 中 第 23 行 语句 中 
的 setAction() 是 设置 动作 的 方法 。 
final String action = intent.getAction(); 
if (Intent. ACTION EDIT. equals(action)) { 


1 
2 
3 //Requested to edit: set that state, and the data being edited. 
4 mState - STATE EDIT; 
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5 mUri = intent.getData(); 

6 } else if (Intent. ACTION INSERT. equals(action)) ( 

7 //Requested to insert: set that state, and create a new entry 
8 //in the container. 

9 mState - STATE INSERT; 

10 mUri = getContentResolver().insert(intent.getData(), null); 
aT 

12 //1f we were unable to create a new note, then just finish 

13 //this activity. A RESULT CANCELED will be sent back to the 
14 //original activity if they requested a result. 

15 if (mUri == null) ( 

16 Log.e(TAG, "Failed to insert new note into" * getIntent().getData()); 
47 finish(); 

18 return; 

19 ) 

20 

21 //The new entry was created, so assume all will end well and 
22 //set the result to be returned. 

23 setResult(RESULT OK, (new Intent()).setAction(mUri.toString())); 
24 

25 }else{ 

26 //Whoops, unknown action! Bail. 

27 Log. e(TAG, "Unknown action, exiting"); 

28 finish(); 

29 return; 

30 ) 


第 16—20 行 定义 第 二 个 过 滤器 ,用 于 声明 用 户 可 以 在 便签 目录 中 新 建 一 页 便签 。 
在 第 三 个 一 activity 之 标签 , 它 声 明了 三 个 过 滤器 ,代码 如 下 。 


1 «activity android:name = "TitleEditor" 

2 id:label- "(Sstring/title edit title" 

3 id: theme = "@android: style/Theme. Dialog" 

4 con = "@drawable/ic_menu_edit" 

" android:windowSoftInputMode = "stateVisible"> 

6 <! -- This activity implements an alternative action that can be 

7 performed on notes: editing their title. It can be used as 

8 a default operation if the user invokes this action, and is 

9 available as an alternative action for any note data. --» 

10 < intent - filter android: label = "(Ostring/resolve title"» 

13 < action android:name = "com. android. notepad. action. EDIT TITLE" /> 

12 < category android:name = "android. intent. category. DEFAULT" /> 

13 < category android:name = "android. intent. category. ALTERNATIVE" /> 

14 < category android:name = "android. intent. category. SELECTED ALTERNATIVE" /> 
15 < data android:mimeType - "vnd. android. cursor. item/vnd. google. note" /> 
16 «/intent - filter» 


17 «/activity» 


(1) 在 这 个 Activity 中 ,实现 一 个 编辑 转变 ,从 编辑 便签 内 容 转变 到 编辑 便签 的 标题 。 
(2) 第 12 一 14 行 声 明了 三 个 过 category 二 ,只 需要 Intent 中 的 一 个 Category 与 其 中 之 


一 匹配 , 便 可 以 验证 通过 。 


3.4.4 


下 面 通过 一 个 简单 的 案例 来 介绍 两 个 Activity 组 件 是 怎样 通过 Intent 进行 通信 的 。 


Intent 使 用 案例 
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【案例 3. 1〗 有 两 个 Activity: ActivityMain 和 ActivitySub, ActivityMain 为 首次 进行 
的 Activity, 其 中 有 个 按钮 , 单 击 该 按钮 可 跳 转 到 ActivitySub 上 ,并 且 在 标题 栏 显示 跳 转 信 
B; ActivitySub 上 也 有 一 个 按钮 , 单 击 该 按钮 可 以 返回 到 ActivityMain 上 , 且 在 标题 栏 显示 
跳 转 返回 信息 。 如 此 循环 往复 。 
[588] 由 于 有 些 知 识 是 后 面 章 节 中 的 内 容 , 这 里 需要 提前 用 到 ,在 此 只 作 简单 介绍 。 
忌 在 两 个 Activity 组 件 中 都 用 到 了 按钮 控件 ,所 以 在 布局 文件 中 ,需要 声明 按钮 控件 , 声 
明 按 钮 的 标签 为 二 Button> 。 
TE Java 代码 文件 中 ,需要 对 按钮 控件 设置 监听 ,使 用 方法 setOnClickListener() ,以 随 
时 捕捉 按钮 的 单 击 信 号 ,一 旦 监听 到 按钮 被 单 击 , 则 执行 onClick() 事 件 方法 定义 的 
操作 。 
扎 在 这 个 案例 中 ,是 两 个 Activity 相互 调用 ,在 创建 Intent 对 象 时 最 好 用 显 式 的 。 在 两 个 
Activity 相 调 中 有 可 能 需要 返回 信息 ,所 以 可 能 需要 使 用 startActivityForResult O J£ 
法 来 发 送 Intent 对 象 。 
CT. startActivityForResult() 方 法 的 使 用 : 通常 情况 下 ,如 果 是 从 A 发 送 Intent 到 B, XM 
B 返 回 到 A, 并 且 还 需要 传递 信息 的 应 用 ,在 A 的 代码 中 使 用 startActivityForResult ) 方 
法 发 送 Intent 到 B, 并 且 还 需要 重 写 onActivityResult() 方 法 用 于 处 理 返回 的 数据 ; 在 
B 的 代码 中 使 用 setResut() 方 法 准备 好 要 回 传 的 数据 ,并 且 需 要 使 用 finish( ) 的 方法 来 
将 打包 好 的 数据 发 回 给 A, 并 且 运 行 A 中 的 onActivityResult() 部 分 的 代码 。 
startActivityForResult() 方 法 的 格式 为 : 


startActivityForResult( Intent intent, Int requestCode) 
onActivityResult() 方 法 的 格式 为 : 

onActivityResult(int requestCode, int resultCode, Intent intent) 
setResut () 方 法 的 格式 为 : 

setResut(int resultCode, Intent intent) 


【开发 步骤 及 解析 】 

(1) 在 Eclipse 中 创建 一 个 名 为 Activity_Intent 的 Android 项 目 。 其 应 用 程序 名 为 Activity 
Intent, 包 名 为 cn. com. sgmsc. Activity Intent. Activity 组 件 名 为 ActivityMain, 

(2) 编写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?> 

2 «LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 
5 android:layout height = "fill parent" 
6 > 

7 «Button android:id- "(9 + id/buttonl" 
8 android:layout width- "wrap content" 


9 android:layout height = "wrap content" 
10 android:text = "进入 ActivitySub" /> 
11 


12 «/LinearLayout > 
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(D 第 7 一 10 行 声明 一 个 按钮 控件 。 


© 第 7 行 定义 这 个 按钮 的 id 变量 名 为 “button1”, 并 添加 该 按钮 资源 到 R. java 文件 中 。 


以 便 在 Java 代码 中 提供 调用 。 
@ 第 10 行 定义 这 个 按钮 上 显示 的 文本 内 容 为 “进入 ActivitySub”。 


(3) 在 res/layout 目录 下 新 建 一 个 XML 文件 ,命名 为 subactivity. xml。 注 意 ,在 res F 


所 有 目录 里 的 文件 名 都 必须 由 小 写字 母 或 数字 命名 。 代 码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 «LinearLayout xmlns:android = "http://schemas.android. com/apk/res/android" 
3 android:orientation- "vertical" android:layout width- "fill parent" 
android:layout height = "fill parent"» 


< Button android: id= "(9 + id/button2" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "返回 ActivityMain" /> 


Poo -auw 


0 
11 «/LinearLayout > 


第 6 一 9 行 声 明 一 个 按钮 控件 。 定 义 按钮 id 变量 名 为 "button2”, 并 添加 该 按钮 资源 到 R. 


java 文件 中 。 定 义 按钮 显示 的 文本 内 容 为 “返回 ActivityMain”。 


(4) 开发 案例 的 主要 逻辑 代码 ,首先 打开 src/cn. com. sgmsc. Activity Intent 包 下 的 


ActivityMain. java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 
package cn. com. sgmsc. Activity Intent; // 声 明代 码 所 在 包 


2 

2 

3 import android. app. Activity; 

4 import android. content. Intent; 


5 eee // 该 处 省 略 了 引入 部 分 的 类 ,可 以 从 指定 网 站 中 下 载 源 代码 查阅 
import android. widget. Button; 


public class ActivityMain extends Activity { 
9 /* 声明 变量 * / 
10 OnClickListener listenerl = null; 


£f Button buttonl; 

12 static final int REQUEST CODE - 1; 

13 

14 / * 当 Ractivity 第 一 次 创建 时 调用 此 方法 * / 

15 @Override 

16 public void onCreate(Bundle savedInstanceState) { 

19 super. onCreate(savedInstanceState); 

18 listenerl = new OnClickListener() { // 创 建 监 听 对 象 并 定义 其 onclick 事件 
19 public void onClick(View v) { 

20 Intent intentl = new Intent(ActivityMain. this, ActivitySub.class); 
21 intentl.putExtra("activitymain", "从 'ActivityMain' 进 入 "); 

22 startActivityForResult( intent1, REQUEST CODE); 

23 $ 

24 285 

25 setContentView(R. layout. main); // 启 动 main. xml 定义 的 布局 


26 buttonl = (Button) findViewById(R. id. buttonl); 


// 将 资源 中 id 号 为 buttonl 的 按钮 控件 赋予 按钮 变量 


27 buttonl.setOnClickListener(listenerl);  // 为 按钮 buttonl 设置 监听 
28 setTitle(" 首 次 进入 'RctivityMain' 页 面 !"); // 设 置 标题 栏 显示 内 容 


63 


v 


64 


Nx 


Android 应 用 开发 教程 


31 /* 当 Activity 第 一 次 创建 时 调用 此 方法 * / 

32 (2 Override 

33 protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
34 if (requestCode == REQUEST CODE) { 


35 if (resultCode -- RESULT CANCELED) 

36 setTitle("JÀR il"); 

37 else if (resultCode == RESULT OK) ( 

38 String temp = null; 

39 Bundle extras = data.getExtras(); 

40 if (extras != null)( 

4l temp = extras.getString("store"); 
42 

43 setTitle(" 现 在 是 在 ActivityMain Hi :" + temp); 
44 ) 

45 } 

46 ) 

47) 


(D 第 4 行 引 入 Intent 所 在 类 ,因为 要 使 用 Intent 对 象 , 所 以 在 代码 前 部 要 引入 该 类 。 

© 第 18 一 24 行 创建 一 个 监听 listenerl ,并 在 创建 的 同时 定义 一 个 onClick 事件 ( 见 第 
19—23 行 )。 在 这 个 事件 中 定义 了 当 监 听 到 按钮 被 单 击 之 后 ,将 会 处 理 的 一 系列 操作 。 

@ 第 20 行 创建 了 一 个 Intent 对 象 ,其 对 象 名 为 “intent1”, 其 动作 值 为 *ActivityMain. 
this”, 其 内 容 值 为 *ActivitySub. class”, 即 它 指定 了 组 件 的 名 称 , 是 一 个 显 式 的 Intent, 

@ 585 21 行 向 intentl 中 添加 一 附加 信息 ,此 附加 信息 是 一 组 键 - 值 对 的 Bundle 信息 ,其 名 
为 “activitymain”, 其 值 为 "从 'ActivityMain' 进 入 ”。 

© 第 22 行使 用 startActivityForResult() 方 法 发 送 intentl 对 象 ,并 同时 发 送 一 个 请 求 码 
REQUEST_CODE 给 ActivitySub。 

© 第 33 一 46 行 重 写 onActivityResult() 方 法 。 通 过 判断 请 求 码 值 和 返回 码 值 ,来 确定 是 
和 否 正确 地 获得 回 传 数据 ,如 果 是 正确 的 便 取出 回 传 数据 ,将 它 显 示 在 标题 栏 信息 中 。 

(5) 在 src/cn. com. sgmsc. Activity Intent 包 下 创建 名 为 ActivitySub. java 的 文件 ,并 编 
辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. Activity Intent; 


X 
2 
3 import android. app. Activity; 

4 import android. content. Intent; 

5 // 该 处 省 略 了 引入 部 分 的 类 ,可 以 从 指定 网 站 中 下 载 源 代码 查阅 
6 import android. widget. Button; 

7 

8 


public class ActivitySub extends Activity ( 
9 OnClickListener listenerl = null; 
10 Button buttonl; 
11 /* 当 Activity 第 一 次 创建 时 调用 此 方法 */ 


12 @Override 

13 public void onCreate(Bundle savedInstanceState) { 
14 super. onCreate(savedInstanceState); 

15 setContentView(R. layout. subactivity); 

16 listenerl = new OnClickListener() { 


17 public void onClick(View v) { 
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18 Bundle bundle = new Bundle(); 

19 bundle. putString("store", "fj 'ActivitySub'jR El"); 
20 Intent intent2 - new Intent(); 

21 intent2.putExtras(bundle); 

22 setResult(RESULT OK, intent2); 

23 finish(); 

24 ) 

25 h 

26 buttonl = (Button) findViewById(R. id. button2); 

27 buttonl.setOnClickListener(listenerl); 

28 String data = null; 

29 Bundle extras 7 getIntent().getExtras(); 

30 if (extras != null) ( 

31 data = extras.getString("activitymain"); 
32 ) 

33 setTitle(" Ei E f E 'ActivitySub'H: " + data); 

34 } 

35] 


(D 58 16—25 行 创建 一 个 监听 listener] ,并 在 创建 的 同时 定义 一 个 onClick 事件 ( 见 第 17 — 
24 行 )。 在 这 个 事件 中 定义 了 , 当 监听 到 按钮 被 单 击 之 后 将 会 处 理 的 一 系列 操作 。 注 意 ,在 
ActivitySub 第 一 次 创建 时 不 会 运行 其 中 的 代码 。 

© 第 18 行 和 第 19 行 创建 一 个 Bundle 对 象 ,名 为 bundle, 并 将 一 组 键 - 值 对 保存 到 其 中 。 
其 名 为 “store”, 其 值 为 “ 自 'ActivitySub' 返 回 ”。 

© 第 20 行 创建 了 一 个 Intent 对 象 ,其 对 象 名 为 intent2”, 其 内 无 任何 信息 。 

@ 第 21 行 向 intent2 中 添加 一 附加 信息 ,此 附加 信息 是 已 保存 bundle 中 的 键 - 值 对 信息 。 

O 第 22 行 是 打包 好 要 回 传 的 数据 。 在 这 里 回 传 一 个 返回 码 值 RESULT. OK 和 intent2 
对 象 。 

© 第 23 行将 打包 好 的 数据 发 回 给 ActivityMain, 并 且 运 行 ActivityMain. java 中 的 
onActivityResult() 里 的 代码 。 

D 第 28 一 33 行 完 成 从 ActivityMain 中 的 intentl 对 象 中 取出 其 附加 信息 ,并 赋予 extras 
( 见 第 29 行 )。 如 果 其 键 - 值 对 非 空 ,就 取出 名 为 “activitymain” 的 对 应 值 给 字符 串 变量 data ,并 
将 data 的 值 显示 在 标题 栏 信息 中 。 

(6) 编写 根 目录 下 的 AndroidManifest. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version="1.0" encoding = "utf - 8"?» 

2 «manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
package = "cn. com. sgmsc. Activity Intent" 
android: versionCode = "1" 


4 
5 android: versionName = "1. 0"> 

6 < application android: icon = "@drawable/icon" android: label = "@string/app_name"> 
LÀ 

8 

9 


w 


«activity android:name = ".ActivityMain" 
android: label = "@string/app_name"> 
< intent - filter > 


10 <action android:name = "android. intent. action. MAIN" /> 

11 < category android:name = "android. intent. category. LAUNCHER" /> 
12 </intent - filter > 

13 </activity> 

14 


15 < activity android: name = " . ActivitySub"></activity > 
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16 

17 </application> 

18 « uses - sdk android:minSdkVersion = "10" /> 
19 


20 </manifest > 


第 15 行 增加 对 Activity 组 件 ActivitySub 的 声 
明 。 这 个 声明 仅 声明 了 Activity 的 名 称 ,没有 其 他 E 
信息 。 —À 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ， 
注意 ,首次 启动 Android 模拟 器 需要 时 间 较 长 ,建议 在 

-打开 Eclipse 时 就 将 Android 模拟 器 打开 ,然后 可 以 

去 做 些 别 的 工作 。 这 样 ,在 需要 运行 Android 应 用 程 
序 时 可 以 节省 些 时 间 。 然 后 运行 Activity_Intent 项 
目 。 运 行 结果 如 图 3-3 一 图 3-5 Bros. 


图 3-3 首次 进入 时 的 ActivityMain 界面 


图 3-4 单 击 按钮 后 进入 ActivitySub 界面 图 3-5 单 击 按钮 后 返回 ActivityMain 界面 


在 案例 3. 1 中 ,多 次 提 到 了 Bundle 对 象 。 在 Android 中 ,关于 Activity 之 间 的 消息 的 传 
递 经 常会 用 到 Bundle。 因 为 在 多 个 Activity 之 间 跳 转 时 ,使 用 Bundle 可 以 比较 方便 保存 并 发 
送 一 组 字符 串 信息 ,这 个 字符 串 信息 可 以 是 一 些 消 息 ,也 可 以 是 用 户 界面 的 某 个 状态 信息 等 。 


3.5 用 户 界 面 状 态 保存 


在 Android 中 ,一 个 Activity 被 激活 并 运行 ,实际 上 是 建立 了 一 个 Activity f 3. ee 当 
Activity 实例 与 用 户 交 互 时 ,会 产生 一 些 状态 信息 。 如 用 户 所 选取 的 值 . 光 标的 位 置 等 。 如 果 
此 时 该 Activity 实例 进入 “暂停 ?或 “停止 ?状态 时 ,需要 保存 这 些 临 时 ibn s ,这 是 
Android 应 用 程序 经 常会 遇 到 的 问题 。 通 常情 况 下 ,Android 使 用 SharedPreferences ,对 象 或 
Bundle 对 象 来 保存 这 些 状 态 信 息 。 


3.5.1 使 用 SharedPreferences 对 象 


SharedPreferences 是 Android 平台 上 一 个 轻 量 级 的 存储 类 ,主要 是 保存 一 些 Activity 的 
状态 信息 如 一 些 用 户 个 性 化 设置 的 字体 .颜色 ,位置 等 参数 信息 。 在 Activity 中 重 载 窗口 状态 
的 参数 SavelnstanceState 一 般 使 用 SharedPreferences 完成 保存 。 

通过 名 称 顾名思义 ,SharedPreferences 好 像 是 一 个 共享 的 Preferences, 但 其 共享 的 范围 
局 限 在 同一 个 Package 中 。 换 句 话 说 ,SharedPreferences 是 将 数据 保存 在 本 应 用 项 目的 私有 
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存储 区 内 ,这 些 存储 区 的 数据 只 能 被 本 应 用 项 目的 程序 所 读 取 。 所 以 实际 上 ,对 于 外 部 的 应 用 
程序 而 言 ,SharedPreferences 对 象 的 访问 权限 是 私有 的 。 

在 所 有 的 Android SDK 存储 技术 中 ,SharedPreferences 技术 是 最 容易 理解 和 使 用 的 , 因 
为 它 处 理 的 就 是 一 个 键 - 值 对 的 二 元 组 ,并 保存 在 一 个 内 部 的 XML 文件 中 ,可 以 在 Eclipse 的 
DDMS 中 的 File Explorer 中 的 /data/data//shares _ prefs 下 找到 这 个 XML X ff. 
SharedPreferences 支持 常见 的 String, Long, Float, Integer, Boolean 等 数据 类 型 。 

每 个 Activity 都 有 一 个 匿名 的 SharedPreferences 对 象 。 获 取 Activity 的 匿名 
SharedPreferences 对 象 ,并 对 它 进行 读 、 写 操作 ,本 书 将 用 个 小 例子 作 简单 介绍 ,其 详细 的 使 
用 方法 参见 第 6 章 。 

例如 想 将 窗口 中 一 个 TextView 控件 中 的 信息 保存 到 Activity 的 匿名 SharedPreferences 
中 ,可 以 使 用 下 列 代 码 片断 实现 。 


1 Protected void saveActivityPreferences()( 

2 SharedPreferences activityPref = getPreferences(Activity.MODE PRIVATE); 

3 // 获 取 Activity 的 匿名 SharedPreferrences 对 象 

4 Editor editor = activityPref.edit(); // 获 取 对 象 的 编辑 器 

5 TextView textView = (TextView)findViewById(R. id. textView); // 获 取 TextView 控件 对 象 
6 editor. putString("TextValue", textView.getText(). toString()); // 存 储 TextView 控件 信息 
7 editor. commit( ) ; // 提 交 并 保存 

8] 


CD 第 4 行 是 得 到 一 个 SharedPreferences 对 象 的 编辑 器 editor, 以 便 让 要 保存 的 信息 写 
到 这 个 对 象 中 。 

(2) 第 6 行 是 将 窗口 中 的 TextView 控件 中 的 内 容 写 入 editor, 其 中 “TextValue” 是 键 - 
值 对 中 的 名 ,使 用 textView. getText O. toString() 方 法 获得 的 字符 串 信 息 则 是 键 - 值 对 中 
的 值 。 

从 这 段 代码 中 可 以 明白 ,如 果 要 用 Activity 的 SharedPreferences 对 象 保存 信息 ,在 编写 
代码 时 一 般 有 如 下 步骤 。 

(1) 获得 SharedPreferences 对 象 。 

(2) 获得 SharedPreferences. Editor 对 象 。 

(3) 使 用 put,…() 方 法 保存 键 - 值 对 。 例 如 保存 字符 串 型 使 用 putString() 方 法 。 

(4) commit() 方 法 进行 提交 。 


3.5.2 使 用 Bundle 对 象 
在 Activity 生命 周期 的 多 个 方法 中 ,都 使 用 了 Bundle 对 象 来 保存 Activity 相关 的 状态 信 


息 。 如 方法 onCreateO ,onSaveInstanceState() ,onRestoreInstanceState() 。 

Bundle 对 象 封装 的 数据 也 是 键 - 值 对 的 二 元 组 ,用 Bundle 绑 定 数据 便于 数据 处 理 。 所 以 ， 
利用 它 的 数据 封装 能 力 , 将 要 传递 的 数据 或 参数 通过 Intent 对 象 来 传递 到 不 同 的 Activity 之 
间 ,是 比较 简便 的 办 法 。Bundle 类 继承 自 Android. os. Bundle 类 。 每 一 个 Android 的 代码 程 
序 都 需要 使 用 它 , 所 以 在 每 个 类 定义 的 代码 文件 前 部 都 必须 加 上 “import android. os. 
Bundle;", 

在 Android 应 用 程序 的 运行 过 程 中 .Bundle 对 象 中 的 数据 是 保存 在 应 用 程序 的 上 下 文中 
的 ,如 果 应 用 程序 退出 ,相应 的 上 下 文 也 就 销毁 了 ,自然 ,Bundle 对 象 也 就 不 存在 了 。 
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使 用 Bundle 对 象 的 常用 方法 如 表 3-5 所 示 。 
表 3-5 Bundle 对 象 的 常用 方法 说 明 


5 —d* i 回 值 dH x 
clear) 清除 所 有 保存 的 数据 
clone() Bundle 对 象 克隆 当前 Bundle 对 象 


返回 指定 键 所 映射 的 值 。 如 果 对 于 此 键 来 


get String key) 指定 key 所 映射 的 值 说 ,映射 不 包含 任何 映射 关系 , 则 返回 null 
返回 指定 键 所 映射 的 值 , 如 果 在 映射 中 不 存 
在 由 指定 键 到 String 类 型 值 的 映射 关系 或 
getString( String key) 指定 key 的 String 类 型 的 值 者 指定 键 在 映射 关系 中 显 式 映射 到 null, 则 
返回 null 
如 果 Bundle 对 象 中 不 包含 任何 键 - 值 映射 关 
isEmpty() true 或 false 


系 , 则 返回 true, 和 否则 返回 false 

给 指定 的 键 关联 一 个 指定 的 String 类 型 值 。 
如 果 此 键 以 前 包含 一 个 映射 关系 , 则 旧 值 被 
替换 。 键 和 值 都 可 以 为 null 

如 果 Bundle 对 象 中 存在 该 键 的 映射 关系 , 则 
将 其 删除 


putString(String key. String 


value) 


remove(String key) 


在 案例 3. 1 的 ActivityMain. java 和 ActivitySub. java 中 都 有 使 用 getString O RI putString 
方法 。 请 读者 回去 看 看 代码 的 用 法 ,在 此 不 作 歼 述 。 


3.5.3 SharedPreferences 与 Bundle 的 区 别 


SharedPreferences 是 简单 的 存储 持久 化 的 设置 ,就 像 用 户 每 次 打开 应 用 程序 时 的 主页 ， 
它 只 是 一 些 简单 的 键 - 值 对 来 操作 。 它 将 数据 保存 在 一 个 XML 文件 中 。 常 用 于 保存 应 用 程 
序 结束 前 的 一 些 界面 状态 信息 ,以 便 下 次 再 打开 应 用 程序 时 能 恢复 关闭 前 的 窗口 画面 。 

Bundle 是 将 数据 传递 到 另 一 个 上 下 文中 或 保存 ,或 回复 你 自己 状态 的 数据 存储 方式 。 它 
的 数据 不 是 持久 化 状态 。 常 用 于 应 用 程序 的 运行 时 , 几 个 Activity 相互 跳 转 时 ,保存 前 一 个 
Activity 的 界面 状态 信息 ,或 用 于 几 个 不 同 的 Activity 之 间 的 数据 传递 等 。 


小 结 


本 章 主要 介绍 了 Android 应 用 程序 运行 时 的 控制 和 通信 。 由 于 在 应 用 程序 运行 时 直接 与 
用 户 交互 的 是 Activity 组 件 , 所 以 本 章 以 Activity 组 件 为 重点 ,逐步 介绍 了 Android 系统 是 如 
何 使 用 任务 、 进 程 和 线程 来 协调 多 个 Activity 在 其 生命 周期 中 的 各 种 状态 的 ,以 及 每 个 
Activity 在 其 生命 周期 中 从 一 个 状态 转变 为 另 一 个 状态 时 ,系统 是 如 何 自 动 有 序 地 调用 生命 
周期 方法 的 。 介 绍 了 多 个 Activity 之 间 相 互 跳 转 时 ,是 如 何 传递 消息 ,如 何 保存 相关 的 状态 信 
息 的 。 

第 2 章 以 静态 的 方式 介绍 Android 应 用 程序 的 组 成 部 分 ,第 3 章 以 动态 的 方式 介绍 
Android 应 用 程序 的 内 部 控制 通信 机 制 。 虽 然 这 两 章 中 对 某 些 知识 点 有 些 重复 提 及 ,但 侧重 
点 不 同 ,所 阐述 的 内 容 也 不 相同 。 通 过 这 一 静 一 动 的 介绍 ,相信 读者 可 以 较 全 面 地 了 解 了 
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Android 应 用 程序 的 框架 结构 及 运行 机 制 ,但 是 如 何 为 这 个 框架 赋予 实际 应 用 价值 ,还 需要 很 
多 构件 来 充实 它 。 从 第 4 章 起 ,将 逐渐 学 习 并 使 用 它们 。 


练习 
eus! 


阅读 Android SDK 例 程 中 ,多 个 Activity 之 间 的 转换 调用 。 例 程 路 径 : SDK 文件 夹 下 的 
samples 子 文件 夹 中 ,本 书 是 E:\android-sdk\samples。 


_Android 常 用 基本 控件 


控件 是 Android 用 户 界面 中 的 一 个 个 组 成 元 素 , 在 介绍 它们 之 前 ,读者 必须 了 解 所 有 控件 
的 父 类 View( 视 图 ) , 它 好 比 一 个 盛 放 控件 的 容器 。 


41 View 类 概述 


对 于 一 个 Android 应 用 来 说 ,android. app. Activity 类 实例 是 一 个 最 基本 的 功能 单元 。 一 
个 Activity 实例 可 以 做 很 多 的 事情 ,但 是 它 本 身 无 法 显示 在 屏幕 上 ,而 是 借助 于 View 和 
ViewGroup ,它们 是 Android 平台 上 最 基本 的 两 个 用 户 界面 表达 单元 。 


4.1.1 关于 View 


View 对 象 是 一 个 数据 体 , 它 的 属性 存储 了 用 于 屏幕 上 一 块 矩 形 区 域 的 布局 参数 及 内 容 ， 
并 负责 这 块 它 所 辖 的 矩形 区 域 之 中 所 有 测量 ,布局 、 焦 点 转换 、 卷 动 以 及 按键 /触摸 手势 的 处 
理 。 作 为 一 个 用 户 界面 对 象 , View 同时 也 担任 着 用 户 交 互 关键 点 以 及 交互 事件 接受 者 的 角 
色 。View 来 自 android. view. View 类 。 在 屏幕 上 ,每 个 View 的 子 类 对 象 都 是 android. view. 
View 类 的 一 个 实例 ,所 有 在 Activity 中 要 用 到 可 视 化 的 窗 体 控件 ,就 必须 在 该 类 定义 的 代码 
文件 前 部 加 上 “import android. view. View;”。 

View 类 是 所 有 屏幕 表达 单元 的 基 类 。View 类 的 所 有 属性 ,以 及 在 View 类 中 定义 的 所 
有 成 员 方法 ,其 子 类 都 全 部 继承 。 表 4-1 描述 了 View 类 常用 的 属性 及 其 对 应 方法 。 


表 4-1 View 类 常用 的 属性 及 对 应 方法 说 明 


属 性 方 法 描 述 

android: background setBackgroundResource(int) 设置 背景 

android:clickable setClickable(boolean) 设置 View 是 否 响应 单 击 事件 

android:visible setVisibleCint) 控制 View 的 可 见 性 

android:focusable setFocusable(boolean) 控制 View 是 否 可 以 获取 焦点 

android:id setld(int) 为 View 设置 标识 符 , 可 通过 findViewById() 
方法 获取 

android:longClickable setLongClickable(boolean) 设置 View 是 否 响应 长 单 击 事件 

android:saveEnabled setSaveEnabled(boolean) 如 果 未 作 设置 , 当 View 被 冻结 时 将 不 会 保存 


其 状态 
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4.1.2 关于 ViewGroup 


ViewGroup 是 一 个 特殊 的 View 类 , 它 继承 于 android. view. View, 是 View 类 的 子 类 。 
ViewGroup 是 充当 其 他 控件 的 容器 ,在 其 内 可 以 有 View 对 象 和 ViewGroup 对 象 , 它 的 功能 
就 是 装载 和 管理 下 一 层 的 View 对 象 和 ViewGroup 对 象 。 确 切 地 说 , 它 是 所 有 容器 类 的 


View 的 布局 显示 方式 直接 影响 用 户 界面 ,准确 地 说 是 一 个 ViewGroup 中 包含 前 


-此 


View 对 象 是 如 何 布局 的 。 在 ViewGroup 中 ,定义 了 一 个 嵌 套 类 ViewGroup. LayoutParams。 
这 个 类 定义 了 一 个 显示 对 象 的 位 置 、 大 小 等 属性 ,View 通过 LayoutParams 中 的 这 些 属性 值 


来 告诉 Android 系统 ,它们 将 如 何 放 置 。 这 就 是 布局 类 。 


在 Android 中 ,布局 类 通常 都 在 布局 的 XML 文件 中 描述 ,而 很 少 在 Java 代码 中 动态 定 
义 。 如 果 使 用 Java 代码 定义 布局 ,那么 在 代码 文件 的 前 部 必须 加 上 “import android. view. 


ViewGroup;”。 


4.2 常见 布局 


布局 (Layout) 是 ViewGroup 的 子 类 ,为 视图 控件 提供 排列 结构 。Android 提供 了 一 些 预 
定义 的 视图 组 , 其 中 包括 FrameLayout，LinearLayout，TableLayout，RelativeLayout， 
AbsoluteLayout。 每 个 都 为 定义 子 视 图 和 布局 结构 提供 了 一 套 独特 的 布局 参数 。 下 面 分 别 


介绍 。 
4.2.1 帧 布局 
帧 布局 (FrameLayout) 是 最 简单 的 一 个 布局 对 象 。 它 里 面 On BDMS 16:54 


framelayout. 


只 显示 一 个 View XE f. Android 屏幕 元 素 中 所 有 的 显示 对 象 pr, 


都 将 会 固定 在 屏幕 的 左上 角 ,不 能 指定 位 置 。 如 果 在 帧 布局 中 
有 多 个 显示 对 象 ,那么 后 一 个 将 会 直接 在 前 一 个 之 上 进行 覆盖 
显示 ,把 前 一 个 部 分 或 全 部 谈 住 。 当 然 ,如 果 后 一 个 显示 对 象 
是 透明 的 , 则 前 一 个 对 象 会 显现 出 来 。 使 用 帧 布局 设计 的 效果 


如 图 4-1 所 示 。 图 4-1 帧 布局 的 显示 效果 


4.2.2 线性 布局 


线性 布局 (LinearLayout) 是 最 常用 的 布局 方式 。 它 以 单一 方向 对 其 中 的 View 对 象 进行 
排列 显示 ,如 果 以 垂直 排列 显示 , 则 屏幕 布局 中 将 只 有 一 列 ; 如 果 以 水 平 排列 显示 , 则 屏幕 布 


局 中 将 只 有 一 行 。 对 于 多 个 显示 对 象 ,线性 布局 保持 它们 之 间 的 间隔 以 及 互相 对 齐 。 使 
性 布局 设计 的 效果 如 图 4-2 和 图 4-3 所 示 。 


线 


在 进行 线性 布局 中 ,可 以 通过 设置 其 属性 值 来 改变 排列 在 其 中 的 显示 对 象 的 显示 效果 。 


常用 的 属性 如 表 4-2 所 示 。 
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5554:avd _apilevel7 


HelloWorld 


Hello, 1 am a Button1 
Hello, I am a Button2 


Hello, 1 am a Button3 
Hello, 1 am a Button4 
Hello, I am a Burton5 


HelloWorld 


Hello, E Hello, B Helio, l| Hello, B Helio, 
lam f ram f lam f 1am f ram 
a a a a a 
Butto f Butto 目 Butto 目 Butto f Butto 
m n2 n3 m n5 


图 4-2 横向 线性 布局 显示 效果 图 4-3 纵向 线性 布局 显示 的 效果 


表 4-2 线性 布局 常用 属性 说 明 


属 性 说 明 

android: background 设置 背景 颜色 

android: orientation 设置 线性 布局 的 排列 方向 。Horizontal 表示 横向 ,vertical 表示 纵向 

android: gravity 设置 线性 布局 内 部 显示 对 象 的 位 置 对 齐 布局 方式 

android; layout. width 设置 线性 布局 的 宽度 。fill_parent 表示 填充 整个 屏幕 ,wrap_content X 
示 按 对 象 上 的 文字 的 宽度 不 同 而 确定 显示 对 象 的 宽度 

android; layout height 设置 线性 布局 的 高 度 。 属 性 值 同 android: layout width 

android: layout_weight 设置 线性 布局 内 部 多 个 显示 对 象 的 重要 度 赋值 , 按 比例 为 它们 划分 
空间 


这 里 ,layout_width、layout_height 及 其 取 值 同样 适用 于 其 他 类 型 的 布局 。gravity 是 一 个 
很 有 用 的 属性 , 它 用 来 设置 线性 布局 内 显示 对 象 的 对 齐 方式 。gravity 可 取 的 值 及 其 说 明 如 
表 4-3 所 示 。 
表 4-3 gravity 可 取 的 属性 值 及 说 明 


属 性 值 说 明 
top 不 改变 显示 对 象 的 大 小 ,对 齐 到 窗口 顶部 
bottom 不 改变 显示 对 象 的 大 小 ,对 齐 到 窗口 底部 
left 不 改变 显示 对 象 的 大 小 ,对 齐 到 窗口 左 侧 
right 不 改变 显示 对 象 的 大 小 ,对 齐 到 窗口 右 侧 
center_vertical 不 改变 显示 对 象 的 大 小 ,对 齐 到 容器 纵向 中 央 位 置 
center_horizontal 不 改变 显示 对 象 的 大 小 ,对 齐 到 容器 横向 中 央 位 置 
center 不 改变 显示 对 象 的 大 小 ,对 齐 到 容器 中 央 位 置 
fill vertical 若 有 可 能 ,纵向 拉 伸 以 填 满 容器 
fill horizontal 若 有 可 能 ,横向 拉 伸 以 填 满 容 器 


fill 若 有 可 能 ,纵向 、 横 向 同时 拉 伸 以 填 满 容器 
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在 线性 布局 中 ,如 果 有 多 个 View 对 象 ,那么 所 有 的 对 象 都 有 一 个 layout. weight 值 ,默认 
为 0, 其 意思 是 按 显示 对 象 的 原来 大 小 显示 在 屏幕 上 。 如 果 layout_weight 值 大 于 0, 则 将 本 线 
性 布局 的 父 视图 中 的 可 用 空间 分 割 ,分割 大 小 具体 取决 于 每 一 个 显示 对 象 的 layout_weight 
值 。 例 如 ,如 果 在 水 平 的 线性 布局 中 有 一 个 文本 标签 和 两 个 文本 编辑 对 象 ,如 果 该 文本 标签 并 
无 指定 layout. weight {E ,那么 它 将 占据 需要 提供 的 最 少 空间 ; 如 果 两 个 文本 编辑 对 象 每 一 个 
的 layout_weight 值 都 设置 为 1, 则 两 者 平分 布局 区 域 的 剩余 宽度 ,因为 这 里 声明 两 者 的 重要 
度 相等 ; 如 果 两 个 文本 编辑 对 象 中 第 一 个 layout_weight 值 设置 为 1 ,而 第 二 个 的 值 设置 为 2， 
于 是 ,第 一 个 占 剩余 宽度 的 三 分 之 二 ,而 第 二 个 占 三 分 之 一 的 宽度 ,因为 layout_weight 的 数值 
越 小 , 越 重要 。 可 见 , 当 线性 布局 中 有 多 个 显示 对 象 时 ,layout_weight 属性 很 重要 , 它 可 以 避 
免 在 一 个 大 屏幕 中 ,一 串 小 对 象 挤 成 一 堆 的 情况 。 

【案例 4.1】 设计 出 如 图 4-2 所 示 的 布局 文件 。 

【说 明 】 图 4-2 中 有 5 个 按钮 ,它们 以 横向 的 线性 排列 方式 显示 在 屏幕 的 顶部 。 因 此 在 
布局 文件 中 要 使 用 layout_weight 属性 且 值 都 相同 。 

[RE] 在 Eclipse 中 导入 Activity_LinearLayout 项 目 ( 可 以 从 清华 大 学 出 版 社 为 本 书 
提供 的 下 载 资源 的 源 代码 中 获得 )。 打 开 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 

2 <LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 

3 android:layout width- "fill parent" 

4 android:layout height = "fill parent" 

5 android:orientation = "horizontal"» 
6 « Button android: id= "(9 + id/buttonl" 
T 
8 


android:layout width = "wrap content" 
android:layout height = "wrap content" 


9 android:text - "Hello, I am a Buttonl" 
10 android:layout weight - "1" 

"n 

12 < Button android: id = "(9 + id/button2" 

13 android:layout width = "wrap content" 
14 android:layout height = "wrap content" 
15 android:text = "Hello, I am a Button2" 
16 android:layout weight - "1" 

17 /> 

18 < Button android: id = "@ + id/button3" 

19 android:layout width- "wrap content" 
20 android:layout height = "wrap content" 
21 android:text = "Hello, I am a Button3" 
22 android:layout weight - "1" 

23 /» 

24 < Button android: id = "(9 + id/button4" 

25 android:layout width- "wrap content" 
26 android:layout height = "wrap content" 
27 android:text - "Hello, I am a Button4" 
28 android:layout weight - "1" 

29 /> 

30 < Button android: id= "(9 + id/button5" 

31 android:layout width- "wrap content" 
32 android:layout height = "wrap content" 
33 android:text - "Hello, I am a Button5" 


34 android:layout weight = "1" 
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35 /> 
36 </LinearLayout > 


COD 第 2 一 36 行 声明 一 个 线性 布局 。 其 中 ,线性 布局 的 属性 定义 在 第 2 一 5 行 ,第 2 行 是 
每 个 Android 布局 文件 必 有 的 ; 第 3 一 4 行 设置 线性 布局 的 宽 和 高 属性 值 , 值 都 是 fill_parent， 
即 充 满 容 器 的 宽 和 高 ; 第 5 行 设 置 线性 布局 的 方向 是 horizontal, 即 是 横向 的 。 

(2) 第 6—11 £1.58 12—17 £5.58 18—23 £5.58 24—29 45.58 30—35 行 分 别 声明 了 5 个 
按钮 ,每 个 按钮 中 的 文本 都 比较 长 ,如 果 不 设置 layout_weight 的 值 ,在 屏幕 的 一 行 中 是 显示 不 


下 所 有 5 个 按钮 的 。 
思考 一 下 : 


如 果 将 每 个 Button 的 属性 “android:1layout_weight 二 1” 都 删 掉 , 会 出 现 什么 样 的 显示 


效果 ? 

线性 布局 允许 嵌 套 。 在 开发 中 ,往往 在 一 个 横向 的 线性 
布局 里 嵌 套 一 个 纵向 的 线性 布局 ,或 在 一 个 纵向 的 线性 布局 
里 嵌 套 一 个 横向 的 线性 布局 。 这 是 非常 常用 的 技巧 。 

【案例 4.2】 设计 出 如 图 4-4 所 示 的 布局 文件 。 

【说 明 】 从 图 4-4 中 可 以 看 到 ,这 个 布局 应 该 是 : 外 层 是 
-个 纵向 的 线性 布局 ,并 且 上 下 两 部 分 的 高 度 是 不 等 比 的 。 
内 层 是 一 个 横向 的 线性 布局 ,并 且 是 等 分 的 两 部 分 。 有 5 个 
按钮 ,它们 以 横向 的 线性 排列 方式 显示 在 屏幕 的 顶部 。 因 此 
在 布局 文件 中 要 使 用 layout_weight 属性 。 

【代码 】 在 Eclipse 中 导入 Activity_NestLineLayonut 项 
目 ( 可 以 从 本 教材 的 源 代码 中 获得 )。 打 开 res/layout 目录 下 
的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 


Activity NesttineLayout 


图 4-4 嵌 套 线性 布局 显示 的 效果 


2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent"» 

6 < LinearLayout 

7 android:orientation = "vertical" 

8 android:layout width- "fill parent" 

9 android:layout height = "fill parent" 

10 android:layout weight = "2"» 

11 < TextView 

12 android:text = "这 个 的 layout_weight 值 为 2" 
13 android:layout width- "fill parent" 
14 android:layout height = "wrap content" 
15 /> 

16 </LinearLayout > 

2 < LinearLayout 

18 android:orientation = "horizontal" 

19 android:layout width- "fill parent" 

20 android:layout height- "fill parent" 

21 android:layout weight = "1"> 

22 < TextView 


23 android:text = "Z[" 
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24 android:gravity- "center horizontal" 
25 android: background = " # aa0000" 
26 android: layout_width = "wrap_content" 
27 android: layout_height = "fill_parent" 
28 android:layout weight = "1" /> 
29 < TextView 
30 android: text = " 绿 " 
31 android:gravity = "center horizontal" 
32 android:background = " # 00aa00" 
33 android: layout width= "wrap content" 
34 android: layout height = "fill parent" 
35 android:layout weight = "1" /> 
36 </LinearLayout > 


37 </LinearLayout > 


CD 第 2—37 行 声 明 的 是 外 层 线性 布局 ,从 第 3 行 知 此 线性 布局 的 方向 是 vertical, BI E 
纵向 的 。 

(2) 第 6 一 16 行 声明 的 是 上 面 的 内 层 线性 布局 。 为 了 与 下 面 的 高 度 不 一 致 ,设置 此 线性 
布局 的 layout. weight 属性 值 为 2。 由 于 此 线性 布局 内 只 有 一 个 二 TextView 过 控件 ,所 以 此 线 
性 布局 的 方向 可 为 横向 ,也 可 为 纵向 ,这 里 设置 的 是 纵向 。 

(3) 第 17 一 36 行 声明 的 是 下 面 的 内 层 线 性 布局 。 此 线性 布局 内 有 两 个 二 TextView 二 控 
件 , 且 其 高 度 应 该 是 上 面 的 两 倍 高 ,所 有 设置 此 线性 布局 的 layout. weight 属性 值 为 1; 设置 此 
线性 布局 的 方向 是 horizontal , 即 是 横向 的 。 


4.2.3 表格 布局 


表格 布局 (TableLayout) 是 线性 布局 的 特殊 类 。 以 拥有 任意 行列 的 表格 对 View 对 象 进 
行 布局 ,每 个 单元 格 内 只 显示 一 个 View 对 象 ,但 单元 格 的 边框 线 不 可 见 。 表 格 布 局 类 每 一 行 
为 一 个 TableRow 对 象 ,在 TableRow 中 可 以 添加 显示 对 象 ,每 添加 一 个 显示 对 象 为 一 列 。 

在 表格 布局 中 ,一 个 列 的 宽度 由 该 列 中 最 宽 的 那个 单元 格 确定 ,而 表格 的 宽度 则 是 由 父 容 
器 确定 。 布 局 中 可 以 有 空 的 单元 格 ,也 可 以 像 HTML 文件 一 样 ,一 个 单元 格 可 以 跨越 多 
个 列 。 

TableLayout 继承 自 LinearLayout 类 , 它 继承 了 线性 布局 所 拥有 的 属性 和 方法 ,但 表格 布 
局 还 有 它 特有 的 ,为 列 设置 有 属性 和 方法 。 表 4-4 是 对 表格 布局 列 的 常用 属性 的 描述 。 


表 4-4 表格 布局 列 的 常用 属性 说 明 
属 性 说 明 


android:collapseColumns ”设置 指定 列 为 Collapsed, 列 号 从 0 开始 计算 。 如 果 列 被 标识 为 Collapsed, 则 该 
列 将 会 被 隐藏 

android:shrinkColumns 设置 指定 列 为 Shrinkable, 列 号 从 0 开始 计算 。 如 果 列 被 标识 为 Shrinkable, W 
该 列 的 宽度 可 以 进行 收缩 ,以 使 表格 能 够 适应 其 父 容 器 的 大 小 

android:stretchColumns 设置 指定 列 为 Stretchable, 列 号 从 0 开始 计算 。 如 果 列 被 标识 为 Stretchable， 
则 该 列 的 宽度 可 以 进行 拉 伸 ,以 填 满 表 格 中 空闲 的 空间 


注意 ,一 个 列 可 以 同时 具有 Shrinkable 和 Stretchable 属性 ,在 这 种 情况 下 ,该 列 的 宽度 将 
可 以 任意 地 进行 收缩 或 拉 伸 以 适应 父 容器 。 
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【案例 4.3】 设计 一 个 三 行 三 列 的 表格 布局 ,其 中 第 一 行 前 两 列 分 别 放 两 个 按钮 ,第 二 行 
后 两 列 分 别 放 两 个 按钮 ,第 三 行 第 三 列 放 一 个 按钮 。 

【说 明 】 这 个 表格 布局 每 一 行 的 显示 对 象 的 位 置 都 不 相同 ,在 布局 文件 中 需要 使 用 
TableRow 类 来 逐 行 定义 。 另 外 ,这 里 没有 对 每 个 按钮 的 宽度 作 要 求 , 在 此 默认 是 等 宽 的 。 

[RE] 在 Eclipse 中 导入 Activity TableLayout 项 目 ( 可 以 从 本 教材 的 源 代码 中 获得 )。 
打开 res/layout 目录 下 的 main. xml 文件, 代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 

2 <TableLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:layout width- "fill parent" 

4 android:layout height = "fill parent" 

5 android:shrinkColumns = "0,1,2"» 

6 < TableRow»«! -- rowl -一 > 

" « Button android:id- "(9 + id/buttonl" 

8 android:layout width = "wrap content" 

9 android:layout height = "wrap content" 


10 android:text = "Hello, I am a Buttonl" 
11 android:layout column = "0" 

12 ^ 

13 < Button android: id = "@ + id/button2" 

14 android: layout_width = "wrap content" 
15 android:layout height = "wrap content" 
16 android:text - "Hello, I am a Button2" 
17 android:layout column = "1" 

18 /> 

19 </TableRow > 

20 <TableRow><! -- row2 --> 

21 < Button android: id= "@ + id/button3" 

22 android:layout width- "wrap content" 
23 android:layout height = "wrap content" 
24 android:text = "Hello, I am a Button3" 
25 android:layout column = "1" 

26 /> 

29 < Button android: id = "(9 + id/button4" 

28 android:layout width- "wrap content" 
29 android:layout height = "wrap content" 
30 android:text = "Hello, I am a Button4" 
31 android:layout column = "1" 

32 /> 

33 </TableRow> 

34 < TableRow ><! -- row3 -一 > 

35 < Button android:id- "(9 + id/button5" 

36 android:layout width = "wrap content" 
37 android:layout height = "wrap content" 
38 android:text - "Hello, I am a Button5" 
39 android:layout column = "2" 

40 ^ 


41 </TableRow > 
42 </TableLayout > 


(1) 第 2 一 42 行 声明 的 是 表格 布局 。 其 中 第 5 行 定义 了 该 表格 是 三 列 的 , 且 是 可 收缩 的 ， 
这 样 ,布局 按照 父 容器 的 宽度 平分 三 列 宽度 ,如 果 每 列 中 的 显示 对 象 超出 了 单元 格 的 宽度 就 自 
动 收缩 至 单元 格 宽度 。 列 号 从 0 开始 计算 。 

(2) 第 6 一 19 行 声明 了 表格 的 第 一 行 。 其 中 有 两 个 按钮 过 Button 之 标签 ,尽管 每 个 按钮 
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的 layout. width 和 layout height 值 都 是 wrap_content, 即 以 文本 的 宽度 、 高 度 为 按钮 的 尺寸 ， 
但 是 由 于 在 二 TableLayout 二 中 设置 属性 “android:shrinkColumns 王 "0,1,2"”, 所 以 最 终 三 列 
还 是 以 三 等 份 来 平分 父 容器 的 宽度 。 

(3) 第 11 行 表示 在 此 行 第 一 列 显示 按钮 1 ,第 17 行 表 示 在 此 行 第 二 列 显示 按钮 2。 

(4) 第 20—33 行 声明 了 表格 的 第 二 行 , 其 中 定义 了 两 个 天 Button 之 标签 。 

(5) 第 25 行 表示 在 此 行 第 二 列 显示 按钮 3, 第 31 行 "TES 
表示 在 此 行 第 二 列 之 后 添加 一 列 ( 即 第 三 列 ) 显 示 按 钮 4。 Helloworid 

(6) 第 34—41 行 声明 了 表格 的 第 三 行 ,其 中 定义 了 

AP Button HRE ,并 定义 在 第 三 列 显示 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 , 然 
后 运行 Activity TableLayout 项 目 。 运 行 结果 如 图 4-5 ti 
所 示 。 


4.2.4 相对 布局 图 4-5 三 行 三 列表 格 布局 的 显示 效果 


相对 布局 (RelativeLayout) 人 允许 通过 指定 View 对 象 相对 于 其 他 显示 对 象 或 父 级 对 象 的 
相对 位 置 来 布局 。 如 一 个 按钮 可 以 放 于 另 一 个 按钮 的 右边 ,或 者 可 以 放 在 布局 管理 器 的 中 央 
等 。 注 意 ,如 果 对 象 A 的 位 置 是 相对 于 对 象 B 来 决定 的 ,那么 必须 先 定义 了 对 象 B, 然 后 才能 
定义 对 象 A。 

在 进行 相对 布局 时 用 到 的 属性 较 多 ,下 面 按 其 属性 值 的 归 类 分 别 进行 介绍 。 

属性 值 为 true 或 false 的 属性 如 表 4-5 所 示 。 


表 4-5 相对 布局 中 取 值 为 true 或 false 的 属性 及 说 明 


属 性 说 明 

android;layout centerHorizontal 当前 显示 对 象 位 于 父 控件 的 横向 中 间 位 置 
android:layout_centerVertical 当前 显示 对 象 位 于 父 控件 的 纵向 中 间 位 置 
android: layout_centerInParent 当前 显示 对 象 位 于 父 控件 的 中 央 位 置 
android: layout_alignParentBottom 当前 显示 对 象 底 端 与 父 控件 的 底 端 对 齐 
android: layout_alignParentLeft 当前 显示 对 象 左 侧 与 父 控件 的 左 侧 对 齐 
android: layout_alignParentRight 当前 显示 对 象 右 侧 与 父 控件 的 右 侧 对 齐 
android: layout_alignParentTop 当前 显示 对 象 顶端 与 父 控件 的 顶端 对 齐 
android; layout_alignWithParentIfMissing 参照 对 象 不 存在 或 不 可 见 时 参照 父 控件 


属性 值 为 其 他 控件 的 id 的 属性 如 表 4-6 所 示 。 
表 4-6 相对 布局 中 取 值 为 其 他 控件 id 的 属性 及 说 明 


属 性 说 明 
android: layout_toRightOf 使 当前 显示 对 象 位 于 给 出 id 控件 的 右 侧 
android;layout toLeftOf 使 当前 显示 对 象 位 于 给 出 id 控件 的 左 侧 
android: layout_above 使 当前 显示 对 象 位 于 给 出 id 控件 的 上 方 
android: layout_below 使 当前 显示 对 象 位 于 给 出 id 控件 的 下 方 
android: layout_alignTop 使 当前 显示 对 象 的 上 边界 与 给 出 id 控件 的 上 边界 对 齐 
android: layout alignBottom 使 当前 显示 对 象 的 下 边界 与 给 出 id 控件 的 下 边界 对 齐 
android: layout_alignLeft 使 当前 显示 对 象 的 左边 界 与 给 出 id 控件 的 左边 界 对 齐 


android: layout_alignRight 使 当前 显示 对 象 的 右边 界 与 给 出 id 控件 的 右边 界 对 齐 
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属性 值 为 像素 单位 的 属性 如 表 4-7 所 示 。 
表 4-7 相对 布局 中 取 值 为 像素 单位 的 属性 及 说 明 


B 性 说 明 
android:layout_marginLeft 当前 显示 对 象 左 侧 的 留 白 
android:layout_marginRight 当前 显示 对 象 右 侧 的 留 白 
android; layout marginTop 当前 显示 对 象 上 方 的 留 白 
android: layout_marginBottom 当前 显示 对 象 下 方 的 留 白 


注意 ,在 进行 相对 布局 时 要 避免 循环 依赖 。 例 如 ,在 相对 布局 中 设置 了 父 容器 的 排列 方式 
为 WRAP_CONTENT, 即 表示 它 将 以 容器 内 的 显示 子 对 象 的 大 小 为 尺寸 ,如 果 此 时 将 其 子 对 
象 设置 为 ALIGN_PARENT_BOTTOM , 即 表 示 它 将 与 父 容器 的 底部 对 齐 。 这 就 出 现 了 循环 
依赖 的 排列 ,因此 造成 子 控件 与 父 控件 相互 依赖 和 参照 的 错误 。 

【案例 4.4】 试 使 用 相对 布局 来 设计 如 图 4-6 所 示 的 界面 效果 。 

【说 明 】 通常 可 以 使 用 柑 套 的 线性 布局 或 者 使 用 表 
格 布局 来 实现 如 图 4-6 所 示 的 用 户 界面 ,但 在 此 需要 使 用 ew 
相对 布局 实现 。 先 来 分 析 一 下 界面 中 各 个 对 象 的 位 置 ,最 
上 方 是 一 个 与 屏幕 左 对 齐 的 文字 串 e n] EFI Text View 
控件 ; 它 的 下 方 是 一 个 可 输入 的 编辑 框 , 并 充满 整个 屏幕 
宽度 ,可 使 用 二 EditText 志 控件; 它 的 下 方 是 两 个 并 排 的 
按钮 ,并 且 是 与 屏幕 右 对 齐 的 。 当 设计 它们 的 显示 位 置 
时 ,一 定 要 找 准 参照 对 象 。 

[RE] 在 Eclipse 中 导入 Activity_RelativeLayout 项 目 ( 可 以 从 本 教材 的 源 代码 中 获 
得 )。 打 开 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


图 4-6 一 个 简单 的 信息 录入 框 界面 


1 <?xml version="1.0" encoding = "utf - 8"?> 
2 <RelativeLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 


3 android: layout width= "fill parent" 

4 android:layout height = "fill_parent"> 
5 

6 < TextView 

Li android:id- "(9 + id/label" 

8 android:layout width = "fill parent" 

9 android:layout height = "wrap content" 
10 android:text = "Type here:" 

11 /> 

12 < EditText 

13 android:id- "(9 + id/entry" 

14 android:layout width- "fill parent" 
15 android:layout height = "wrap content" 
16 android:background = " (Qandroid:drawable/editbox background" 
17 android:layout below = "(9 id/label"/» 
18 « Button 

19 android: id= "(à + id/ok" 

20 android:layout width- "wrap content" 
21 android:layout height = "wrap content" 
22 android:layout below = "(9 id/entry" 


23 android:layout alignParentRight - "true" 
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24 android:layout marginLeft = "10dip" 

25 android: text = "OR" /> 

26 < Button 

27 android:layout width- "wrap content" 
28 android:layout height = "wrap content" 
29 android:layout toLeftOf = "(à)id/ok" 

30 android:layout alignTop = "@ id/ok" 

31 android: text = "Cancel" /> 

32 


33 </RelativeLayout > 


(1) 第 2 一 33 行 声明 了 一 个 相对 布局 ,并 且 这 个 相对 布局 的 宽度 和 高 度 都 充满 屏幕 。 

(2) 第 6~11 行 声 明了 一 个 二 TextView 二 控件 , 它 的 ID 为 “label”, 显 示 内 容 为 “Type 
here:”。 第 8 行 设置 该 文本 框 的 宽度 是 fill_parent, 即 填 满 其 父 容器 。 第 9 行 设置 的 高 度 为 
wrap_content, 即 其 高 度 为 文本 的 高 度 。 

(3) 第 12—17 行 声 明了 一 个 二 EditText 盖 控件 , 它 的 ID 为 “entry”。 第 17 行 设置 本 编辑 
框 的 位 置 ,指定 它 位 于 ID 为 “label” 的 二 TextView 过 控件 的 下 方 。 

(4) 第 18 一 25 行 声 明了 一 个 二 Botton 过 控件 , 它 的 ID 为 “ok”。 第 22 行 设 置 本 按钮 的 位 
置 ,指定 它 位 于 ID 为 “entry” 的 二 EditText 过 控件 的 下 方 ; 第 23 行 指定 它 与 父 容器 的 右 侧 对 
齐 ; 第 24 行 指定 本 按钮 的 左 侧 留 白 为 10dip; 按钮 上 显示 的 文本 为 “OK”。 

(5) 第 26—31 行 声 明了 一 个 过 Botton 二 控件。 第 29 行 设置 本 按钮 位 于 ID 为 “ok” 的 按 
钮 控件 的 左 侧 ,并 由 第 24 行 知 与 “ok” 按 钮 控件 的 间距 为 10dip; 第 30 行 指定 它 与 OK 按钮 控 
件 的 上 边界 对 齐 ; 按钮 上 显示 的 文本 为 “Cancel”。 


4.2.5 绝对 布局 


绝对 布局 (AbsoluteLayout) 人 允许 以 坐标 的 方式 ,指定 View 对 象 的 具体 位 置 , 左 上 角 的 坐 
标 为 (0, 0) ,向 下 及 向 右 , 坐 标 值 变 大 。 这 种 布局 管理 器 由 于 显示 对 象 的 位 置 定 死 了 ,所 以 在 
不 同 的 设备 上 ,有 可 能 会 出 现 最 终 的 显示 效果 不 一 致 的 情况 。 

由 于 每 一 个 显示 对 象 都 是 通过 计算 其 坐标 来 定位 和 布局 的 ,与 周围 的 其 他 控件 和 父 容器 
无 关 , 所 以 绝对 布局 是 一 种 用 起 来 比较 费时 的 布局 管理 器 。 

现在 已 经 介绍 完 Android 的 5 类 布局 管理 器 。 这 些 布局 各 有 特点 ,在 开发 时 ,应 该 根据 实 
际 应 用 的 用 户 界面 ,选择 合适 的 布局 管理 器 。 下 面 给 出 一 些 应 用 实例 的 用 户 界 面 ,如 图 4-7 所 
示 。 你 能 说 出 它们 各 使 用 了 什么 布局 吗 ? 


图 4-7 几 种 常见 的 用 户 界面 布局 
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人 3 Android 常见 的 基本 控件 


部 件 (Widget) 是 为 构建 用 户 交互 界面 提供 服务 的 视图 对 象 。Android 和 其 他 开发 语言 一 
FÉ ,提供 一 套 完 整 的 部 件 实现 。 常 用 的 Widget 包括 TextView , Edit Text , Button, RadioButton, 
Checkbox 和 ScrollView 等 。 巾 于 它们 每 一 个 都 可 以 与 用 户 进行 交互 ,所 以 把 Widget 类 中 的 
每 一 个 部 件 称 为 控件 。 

Widget 类 是 View 类 的 子 类 , Widget 内 的 所 有 控件 都 继承 了 View 类 中 的 属性 和 方法 。 
可 以 在 android. widget 包 中 找到 Android 提供 的 控件 列表 。 下 面 分 别 进行 介绍 。 


4.3.1 TextView 


TextView( 文 本 框 ) 是 用 来 向 用 户 显 示 文 本 内 容 的 控件 。 它 在 android. widget. TextView 
包 中 定义 ,如 果 在 Java 类 设计 中 使 用 它 , 则 需要 在 相应 的 代码 文件 前 部 加 上 “import android. 
widget. TextView;", 

TextView 控件 中 有 很 多 可 以 在 XML 文件 中 设置 的 属性 ,这 些 属 性 同样 可 以 在 代码 中 以 
方法 动态 声明 。 常 用 的 属性 和 对 应 的 方法 如 表 4-8 所 示 。 


表 4-8 TextView 常用 的 属性 和 对 应 方法 说 明 


属 性 方 法 描 g 
android: gravity setGravityCint) 设置 TextView 在 x 轴 和 y 轴 方向 上 的 显示 方式 
android:height setHeight(int) 设置 TextView 的 高 度 , 以 像素 为 单位 
android; width setWidth(int) 设置 TextView 的 宽度 ,以 像素 为 单位 
android:hint setHintCint) 当 TextView 中 显示 的 文本 内 容 为 空 时 ,显示 的 文本 

提示 信息 

android:padding setPadding(int) 设置 TextView 中 显示 文本 与 其 父 容器 边界 的 间距 
android :text setText(CharSequence) 为 TextView 设置 显示 的 文本 内 容 
android:textColor ”setTextColor(ColorStateList) ”设置 TextView 的 文本 颜色 
android:typeface setTypeface(Typeface) 设置 TextView 的 文本 字体 
android; textSize setTextSize(float) 设置 TextView 的 文本 大 小 
android:textStyle — setTextStyle(TextStyle) 设置 TextView 的 文本 字形 ,如 粗 体 .斜体 等 


在 使 用 中 ,要 注意 一 些 属性 的 区 别 。 
1. android:gravity 与 android:layout_gravity 的 区 别 


android:gravity 用 于 设置 这 个 View 内 的 所 有 子 元 素 的 对 齐 方式 ,而 android: layout_ 
gravity 用 于 设置 这 个 View 在 其 父 容器 中 的 对 齐 方式 。 


2. android: padding 与 android:layout_margin 的 区 别 


padding 是 站 在 父 View 的 角度 描述 问题 的 , 它 规定 它 里 面 的 内 容 必 须 与 这 个 父 View XI 
界 的 距离 。 而 margin 则 是 站 在 自己 的 角度 描述 问题 的 ,规定 自己 和 其 他 (上 下 左右 ) 的 View 
之 间 的 距离 ,如 果 同 一 级 只 有 一 个 View ,那么 它 的 效果 基本 上 就 和 padding 一 样 了 。 


第 4 章 ”Android 常 用 基本 控件 


【案例 4.5】 试 设计 如 图 4-8 所 示 的 布局 文件 片段 。 "PI 

【说 明 】 这 个 TextView 控件 有 背景 色 , 需 要 使 用 android. MM 
background 属性 ,文本 颜色 是 白色 的 ,需要 使 用 androids GELOS 
textColor 属性 。 颜 色 常量 使 用 “#1 RRGGBB”6 位 十 六 进 制 数 
表示 。 

【代码 】 布局 文件 中 的 代码 片断 如 下 所 示 。 


图 4-8 一 个 TextView 控件 


1 <TextView 
2 android: id= "(2 + id/text view" 
3 android:layout width- "fill parent" 
4 android:layout height = "wrap content" 
5 android:textSize = "l6sp" 
6 android:textColor = " # ffffff" 
T android:padding = "10dip" 
8 android:background = " # cc0000" 
9 android:text = "这 里 是 TextView, 你 可 以 在 这 里 输入 需要 显示 的 文字 信息 .." 
10 /> 
CD 第 1 一 10 行 声 明了 一 个 TextView 控件 。 
(2) 第 5 行 设置 文本 的 字符 大 小 , 即 16sp。 在 2. 2. 1 节 中 已 经 说 明 描 述 字符 的 单位 使 用 spo 
(3) 第 6 行 设置 文本 的 颜色 ,“#ffffff" 为 纯 白 色 。 
(4) 第 7 行 设置 文本 与 其 父 容器 ( 即 文本 框 ) 边 界 的 间距 为 10 像素 。 可 以 看 出 图 4-8 中 的 
文本 与 红色 区 域 的 边界 是 有 10 个 像素 的 间隔 。 
(5) 第 8 行 设置 文本 框 的 背景 颜色 ,“#cc0000” 为 红色 。 
(6) 第 9 行 设置 文本 框 的 显示 内 容 。 


4.3.2 EditText 


EditText( 编 辑 框 ) 是 用 来 向 用 户 显示 文本 内 容 , 并 允许 用 户 对 文本 进行 编辑 的 控件 。 在 
开发 中 经 常会 使 用 到 这 个 控件 ,例如 ,实现 登录 界面 时 ,需要 用 户 输 入 账号 、 密 码 等 信息 ,这 时 
需要 用 到 此 编辑 控件 。EditText 控件 定义 在 android. widget. EditText 包 中 ,如 果 在 Java 类 
设计 中 使 用 它 , 则 需要 在 相应 的 代码 文件 前 部 加 上 “import android. widget. EditText;”。 

EditText 类 继承 自 TextView, 有 许多 EditText 控件 中 的 属性 和 对 应 方法 ,对 TextView 
控件 同样 适用 。 下 面 列 出 EditText 控件 常用 的 属性 和 方法 ,如 表 4-9 所 示 。 

表 4-9 EditText 常用 的 属性 和 对 应 方法 说 明 


属 性 方 法 描 述 
android:cursorVisible setCursorVisible (boolean) 设置 光标 是 否 可 见 ,默认 可 见 
android; lines setLinesCint) 设置 固定 行 数 以 确定 EditText 的 高 度 
android : maxLines setMaxLinesCint) 设置 最 大 的 行 数 
android:maxLength setFilters(InputFilter) 设置 最 大 的 显示 长 度 
android: password setTransformationMethod 设置 显示 是 否 为 密码 模式 

(TransformationMethod) 
android:phoneNumber setKeyListener( KeyListener) 设置 显示 文本 只 能 是 电话 号 码 
android:scrollHorizontally setHorizontallyScrolling( boolean) 设置 文本 框 是 否 可 以 进行 水 平 滚动 
android :singleLine setTransformationMethod 设置 文本 框 为 单行 模式 


CTransformationMethod) 
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【案例 4.6】 试 设计 如 图 4-9 所 示 的 布局 文件 片段 。 
【说 明 】 这 个 EditText 控件 有 一 定 的 宽度 ,并 且 与 屏幕 e 
右 侧 对 齐 , 需要 使 用 layout gravity 属性 。 注 意 , 此 时 
EditText 控件 中 的 文本 是 居中 的 ,需要 使 用 gravity 属性 。 
【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 


1 «EditText android: id= "@ + id/edit text" 
2 android:layout width = "100dip" 
3 android:layout height = "wrap content" 
4 android:text = "one" 
5 
6 


图 4-9 一 个 EditText 控件 


android:gravity = "center" 
android:layout gravity = "right" /> 
CD 第 1 一 6 行 声 明了 一 个 EditText 控件 。 
(2) 第 2 行 设置 EditText 的 宽度 为 100 像素 。 
(3) 第 5 行 设置 EditText 中 的 文本 居中 。 
(4) 第 6 行 设置 EditText 控件 与 屏幕 右 侧 对 齐 。 


4.3.3 Button 


Button( 按 钮 ) 是 用 得 最 多 的 控件 ,在 前 面 的 多 个 示例 中 都 已 经 见 到 了 按钮 。 在 Android 
台中 ,按钮 是 通过 Button 来 实现 的 。 实 现 过 程 也 非常 简单 。 当 用 户 对 按钮 按 下 或 单 击 之 
后 ,按钮 控件 就 会 触发 onClick 事件 ,所 以 需要 对 按钮 设置 setOnClickListener 事件 监听 。 相 
关 按 钮 的 事件 及 事件 监听 将 在 第 5 章 作 详细 介绍 。 

Button 定义 于 android. widget. Button 类 中 ,如 果 在 Java 类 设计 中 使 用 它 , 则 需要 在 相应 
的 代码 文件 前 部 加 上 “import android. widget. Button;", 

Button 继承 自 TextView 类 ,Button 的 背景 可 以 是 背景 颜色 ,也 可 以 是 背景 图 片 , Button 
上 可 显示 文本 ,Button 的 大 小 可 设置 等 ,这 些 属性 和 相应 的 方法 与 TextView 控件 的 属性 和 方 
法 相同 。 


4.3.4 ImageButton 


ImageButton( 图 片 按钮 ) 控 件 与 Button 控件 和 功能 一 致 ,但 在 显示 效果 上 是 不 一 样 的 , 它 
们 的 主要 区 别 是 ImageButton 中 没有 text 属性 , 即 按钮 中 只 显示 图 片 而 不 显示 文本 。 
ImageButton 继承 自 ImageView 类 。ImageButton 控件 中 设置 按钮 显示 的 图 片 可 以 通过 
android: src 属性 ,如 果 在 代码 中 动态 设置 图 片 则 使 用 setImageResource(int) 方 法 来 实现 。 
在 默认 的 情况 下 ,ImageButton 5 Button 一 样 都 具有 背景 色 ,但 是 ,为 了 不 影响 图 片 的 显 
IR ,一 般 要 将 其 背景 色 设置 为 透明 或 其 他 的 图 片 。 
下 面 通 过 一 个 案例 来 说 明 如 何 为 ImageButton 按钮 的 不 同 状态 设置 不 同 的 显示 图 片 。 
【案例 4.7] 设计 两 个 ImageButton 按钮 ,这 两 个 按钮 在 未 被 按 下 时 都 显示 如 图 4-10(a) 


所 示 的 图 片 。 但 当 它们 被 按 下 时 ,第 一 个 图 片 按钮 显示 不 同 的 背景 
© 色 , 而 第 二 个 图 片 按钮 显示 如 图 4-10Cb) 所 示 的 图 片 。 
(9 O 【说 明 】 首先 必须 把 这 两 个 图 片 文件 存放 在 项 目的 res 下 的 


图 4-10 ”按钮 图 片 drawable 目录 中 (也 可 以 是 drawable-hdpi、drawable-ldpi 或 drawable- 
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mdpi) ,然后 使 用 android : src 属性 为 ImageButton 设置 显示 图 片 。 对 于 按钮 一 ,只 设置 了 按钮 
未 被 按 下 时 显示 的 图 片 ,对 于 按钮 二 ,还 需要 设置 按钮 被 按 下 时 显示 的 图 片 , 这 时 ,需要 在 图 片 
资源 存放 的 目录 中 编写 一 个 XML 文件 ,用 于 描述 按钮 的 两 个 状态 各 显示 的 图 片 。 

【布局 设计 步骤 】 

COD) 这 里 ,如 图 4-10(a) 所 示 的 图 片 文件 名 为 play. png, WE 4-10(b) 所 示 的 图 片 文件 名 为 
playb. png。 在 该 项 目的 res 目录 中 创建 一 个 名 为 drawable 的 目录 ,将 这 两 个 图 片 文件 复制 到 
新 建 的 目录 中 。 

(2) 在 res/layout 目录 下 创建 一 个 名 为 myselector. xml 的 文件 ,用 于 设置 按钮 在 不 同 状 
态 下 显示 不 同 的 图 片 文 件 , 代 码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 «selector xmlns:android = "http://schemas. android. com/apk/res/android"> 

3 «item 

4 android:state pressed = "false" 

5 android:drawable = "(Üdrawable/play"/» <! -- 设置 按钮 未 被 按 下 时 的 图 片 --> 
6 <item 

7 android: state_pressed = "true" 

8 android:drawable = "@drawable/playb"/> <! -- 设置 按钮 按 下 时 的 图 片 --> 

9 «/selector» 


(D 第 2 一 19 行 声 明 图 片 按钮 的 选择 标签 (EH < selector > HRE 。 

© 第 3 一 5 行 声明 按钮 未 被 按 下 状态 时 的 图 片 资源 。 这 里 使 用 二 item 之 标签 ,按钮 未 被 
按 下 时 用 "android:state_pressed 一 "false"" 判 断 , 用 属性 设置 图 片 源 , 即 “android: drawable 一 
"@drawable/play"”。 

G 588 6—8 行 声明 按钮 被 按 下 状态 时 的 图 片 资源 ,此 时 设置 图 片 资源 为 “android: 
drawable- "(2 drawable/playb"" , 

(3). 编写 res/layout 目录 下 的 布局 文件 ,在 这 个 项 目 中 设计 本 案例 的 布局 文件 名 为 image 
button, xml 文件 ,代码 如 下 所 示 。 


1 <?xml version="1.0" encoding = "utf 一 8"?> 
2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


3 android:orientation = "vertical" android:layout width = "fill parent" 
4 android:layout height = "wrap content"» 

5 

6 < TextView 

? android:layout width- "wrap content" 

8 android:layout height = "wrap content" 

9 android:text = "两 个 图 片 按钮 :”/> 

10 

11 < ImageButton 

12 android: id= "(à + id/image_button1" 

13 android: src = "@drawable/play" 

14 android:layout width- "wrap content" 

15 android:layout height = "wrap content"/» 
16 < InageButton 

17 android:id- "(à + id/image button2" 

18 android:src = "(2 drawable/myselector" 


19 android:layout width- "wrap content" 
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20 android:layout height = "wrap content"/> 
21 
22 «/LinearLayout > 


(D 58 2—22 行 声 明了 一 个 线性 布局 。 其 内 有 三 个 控件 ,一 个 TextView 控件 ,两 个 
ImageButton 控件 。 

@ 第 11 一 15 行 声明 第 一 个 图 片 按钮 ,其 ID 为 "image_ 
buttonl", 58 13 行 设 置 该 按钮 未 被 按 下 时 的 显示 图 片 为 图 
片 资 源 目录 中 的 “play. png”. 

@ 第 16 一 20 行 声明 第 二 个 图 片 按钮 .其 ID 为 “image_ 
button2”。 第 18 行 设置 该 按钮 未 被 按 下 和 被 按 下 两 种 状态 
的 显示 图 片 由 图 片 资源 目录 中 的 myselector. xml 文件 描述 。 

【运行 效果 】 图 4-11 一 图 4-13 分 别 是 这 两 个 图 片 按钮 ”图 4-11 两 按钮 都 未 被 按 下 时 
在 两 种 状态 下 的 运行 效果 。 的 显示 效果 


"omageBütton Activity. 


fimageButton Activity 


回 


FimageBütton Activity. 


回 
p] 


图 4-12 当 按 钮 一 被 按 下 时 的 显示 效果 图 4-13” 当 按钮 二 被 按 下 时 的 显示 效果 


4.3.5 Checkbox 和 RadioButton 


CheckBox 与 RadioButton( 复 选 按 钮 与 单 选 按 钮 ) 是 开发 中 经 常 需要 用 到 的 选择 按钮 , 通 
常 一 组 单 选 按钮 需要 编制 到 一 个 RadioGroup 中 。 相 信 读 者 对 它们 并 不 陌生 。CheckBox 与 
RadioButton 都 继承 自 CompoundButton 类 ,它们 也 都 从 父 类 CompoundButton 中 继承 了 一 些 
成 员 方 法 ,常用 的 方法 及 说 明 如 表 4-10 所 示 。 
表 4-10 CheckBox 与 RadioButton 常用 的 方法 及 说 明 


5 法 描 述 
isChecked () 判断 是 否 被 选中 ,如 果 被 选中 返回 true, 否 则 返回 false 
performClick() 调用 OnClickListener 监听 器 , 即 模拟 一 次 单 击 
setChecked(boolean checked) 通过 传人 的 参数 设置 控件 状态 
toggle() 置 反 控件 当前 的 状态 , 即 原 为 选中 状态 时 返回 未 选中 


状态 ,或 原 为 未 选中 状态 时 返回 选中 状态 
setOnCheckedChangeListener(CompoundButton。 ”为 控件 设置 OnCheckedChangeListener 监听 器 


OnCheckedChangeListener listener) 


【案例 4.8】 试 设计 如 图 4-14 所 示 的 布局 文件 片段 。 
【说 明 】 这 组 CheckBox 控件 是 将 文本 标签 的 字形 作为 复 选 项 ,并 且 是 以 所 见 即 所 得 的 
形式 ,标注 什么 字形 就 显示 什么 字形 ,因此 用 textStyle 属性 。 
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MY 


【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 


< CheckBox android: id = "@ + id/plain cb" 
android:text = "Plain" 

android:layout width = "wrap content" 
android:layout height = "wrap content" 


< CheckBox android: id = "(9 + id/serif cb" 
android:text - "Serif" 

android:layout width 
android:layout height = "wrap content" 


1 

2 

3 

4 

5 f> 
6 

7 

8 "wrap content" 
9 


10 android:typeface = "serif" 

11 /> 

12 < CheckBox android:id= "(à + id/bold cb" 

13 android: text = "Bold" 

14 android: layout_width = "wrap content" 
15 android:layout height = "wrap content" 
16 android:textStyle = "bold" 

17 /> 

18 < CheckBox android:id ="@ + id/italic cb" 
19 android:text = "Italic" 

20 android:layout width = "wrap content" 
21 android:layout height = "wrap content" 
22 android:textStyle = "italic" 

23 /> 


CD 这 里 声明 了 4 个 CheckBox 控件 。 
(2) 第 10,16,22 行 设置 CheckBox 控件 显示 标签 的 字形 。 


ü wi d 6:46 


CheckBox Acti 


Plain breakfast 


Serif * lunch 


Bold dinner 


Italic 


all 


图 4-14 一 组 CheckBox 控件 图 4-15 一 组 RadioButton 控件 


【案例 4.9】 试 设计 如 图 4-15 所 示 的 布局 文件 片段 。 
【说 明 】 这 组 RadioButton 控件 是 将 一 日 的 餐 名 列 出 , 供 选择 。 如 果 有 多 个 单 选 按钮 组 
成 一 组 ,需要 用 一 个 RadioGroup 控件 把 它们 编 成 一 组 ,在 这 个 组 内 ,同一 时 刻 只 能 有 一 个 按 


钮 处 于 选中 状态 。 
【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 
1 «RadioGroup 
2 android:layout width- "fill parent" 
3 android:layout height - "wrap content" 
4 android:orientation = "vertical" 
5 android:checkedButton = "(à + id/lunch" 
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6 android: id= "@ + id/menu"> 

7 < RadioButton 

8 android:text = "breakfast" 

9 android:id- "@ + id/breakfast" /> 
10 < RadioButton 

11 android:text = "lunch" 

12 android: id = "@id/lunch" /> 

13 < RadioButton 

14 android:text = "dinner" 

15 android: id= "@ + id/dinner" /> 
16 < RadioButton 

17 android:text = "all" 

18 android: id= "@ + id/all" /> 


19 </RadioGroup > 


(1) 第 1 一 19 行 


声 
(2) 第 4 行 设置 这 
这 


(3) 第 5 行 设置 


4.3.6 


ImageView 


1. ImageView( 图 片 ) 控 件 


明了 一 个 RadioGroup 控件 ,其 内 定义 了 4 个 RadioButton 按钮 。 
组 单 选 按钮 是 纵向 排列 的 。 
个 RadioGroup 组 中 ID 为 “lunch” 的 单 选 按钮 为 选中 状态 。 


ImageView 控件 负责 显示 图 片 。 除 了 显示 图 片 之 外 ,还 可 以 对 图 片 执 行 一 些 其 他 的 操 
作 , 例 如 设置 它 的 alpha 值 ,调整 图 片 的 尺寸 等 。 
图 片 来 源 有 多 种 途径 : 可 以 是 资源 文件 的 ID, 也 可 以 是 drawable 目录 中 的 图 片 对 象 ,还 
可 以 是 Content Provider 中 的 URI 等 。ImageView 控件 中 常用 到 的 属性 和 对 应 方法 


如 表 4-11 所 示 。 


表 4-11 ImageView 中 常用 的 属性 和 对 应 方法 说 明 
属 性 方 法 描 x 
android:adjustViewBounds setAdjustViewBounds(boolean) 设置 是 否 需要 ImageView 调整 自己 的 
边界 来 保证 显示 的 图 片 的 长 宽 比 例 


android:maxHeight 
android; maxWidth 
android; scaleType 


android: src 


setMaxHeight(int) 
setMaxWidth(int) 
setScaleType(ImageView. ScaleType) 


setImageResource(int) 


可 选项 ,设置 ImageView 的 最 大 高 度 

可 选项 ,设置 ImageView 的 最 大 宽度 
调整 或 移动 图 片 来 适应 ImageView 的 
尺寸 。 如 : 当 ScaleType 取 值 为 center/ 
CENTER 时 按 图 片 的 原 尺寸 居中 显示 
当 ScaleType 取 值 为 centerCrop/ 
CENTER_CROP 时 按 比 例 扩 大 图 片 尺 
寸 并 居中 显示 ; MP ScaleType 取 值 为 
fitCenter /FIT_CENTER 时 把 图 片 按 比 
例 扩大 /缩小 到 View 的 宽度 ,居中 显 
示 ; 当 ScaleType 取 值 为 fitXY/FIT_ 
XY 时 把 图 片 不 按 比例 扩大 /缩小 到 
View 的 大 小 显示 

设置 ImageView 要 显示 的 图 片 源 


第 4 章 Android 常 用 基本 控件 “87 


ImageView 控件 还 有 些 常 用 成 员 方 法 ,如 表 4-12 所 示 。 
表 4-12 ImageView 中 常用 的 方法 说 明 


方 法 Hx 
setAlphaCint) 设置 ImageView 的 透明 度 
setImageBitmap( Bitmap) 设置 ImageView 所 显示 的 内 容 为 指定 的 Bitmap 对 象 
setImageDrawable (Drawable) 设置 ImageView 所 显示 的 内 容 为 指定 的 Drawable 对 象 
setImageResource (int) 设置 ImageView 所 显示 的 内 容 为 指定 ID 的 资源 
setImageURI(Uri) 设置 ImageView 所 显示 的 内 容 为 指定 URI 
setSelected(boolean) 设置 ImageView 的 选中 状态 


【案例 4.10】 试 设计 如 图 4-16 所 示 的 布局 文件 片段 。 

【说 明 】 这 个 界面 中 除了 显示 了 一 个 水 平 居 中 的 
ImageView 控件 外 ,在 其 上 方 还 有 一 串 文本 。 本 界面 实际 上 
有 两 个 控件 。 

【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 


<TextView 


android:layout width= "wrap content" 


图 4-16 一 个 ImageView 控件 


android:layout height = "wrap content" 


android: text = " 安 卓 图 片 是 这 样 的 :”/> 


< ImageView 
android:id- "@ + id/imagebutton" 
android: src = "@drawable/andd" 


ii 
2 
3 
4 
5 
6 
7 
8 
9 android:layout width = "wrap content" 


10 android:layout height = "wrap content" 

11 android:layout gravity = "center" 

12 /> 

COD 第 1—4 行 声明 了 一 个 TextView 控件 ,显示 文本 信息 。 

(2) 第 6 一 12 行 声 明了 一 个 ImageView 控件 。 其 中 ,第 8 行 设 置 该 控件 的 图 片 来 源 于 
drawable 目录 中 的 andd. png 文件; 第 11 行 设 置 该 图 片 控件 位 于 屏幕 的 横向 居中 位 置 。 

Android 支持 常见 的 静态 图 片 格式 ,如 :; PNG, 9. PNG,JPG 和 GIF 格式 等 。 注 意 ， 
Android 还 不 支持 动态 的 GIF 格式 。 这 里 提 到 的 9. PNG 格式 的 图 是 一 种 比较 特别 的 图 片 格 
式 ,下 面 专门 介绍 。 


2. 9Patch 图 片 简 介 


9Patch 图 片 是 一 种 特殊 的 PNG 图 片 格式 ,以 “. 9. png” 结 尾 。9Patch 图 片 可 以 实现 部 分 
拉 伸 ,这 种 图 片 与 通常 的 只 以 “. png” 结 尾 的 图 片 不 一 样 ,如 果 直 接 拉 伸 普通 的 PNG 图 会 有 失 
真 现象 出 现 ,所 以 它 通常 被 用 作 背 景 图 使 用 。 

9Patch 图 片 和 普通 图 片 的 区 别 是 四 周 多 了 一 个 边框 ,如 图 4-17 所 示 。 

1) 9Patch 图 片 的 伸缩 规则 

9Patch 图 片 的 伸缩 规则 主要 由 左 、 上 侧 , 右 、 下 侧 的 黑 线 确定 。 一 般 情况 左 侧 黑 线 比 右 侧 
的 短 , 上 侧 黑 线 比 下 侧 的 短 。 右 侧 和 下 侧 的 黑 线 可 以 省 略 。 
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如 图 4-18 所 示 , 以 左 侧 和 上 侧 的 黑 线 两 端 为 标准 ,可 画 出 4 条 直线 ,将 原 图 切割 成 9 个 区 
域 (4 个 角 ,4 条 边缘 和 一 个 中 心 区 域 ) ,各 个 区 域 有 不 同 的 拉 伸 控制 (角落 不 拉 伸 , 横 边 横向 拉 
伸 , 竖 边 竖 向 拉 伸 ,中 心 区 域 横竖 向 都 拉 伸 )。 这 样 , 使 用 9-patch 图 片 在 伸缩 时 ,其 圆 角 及 边 
缘 可 避免 变形 。 

如 图 4-19 所 示 ,右边 的 黑色 线 代 表 内 容 绘 制 的 垂直 区 域 ,下 边 的 黑色 线 代 表 内 容 绘制 的 
水 平 区 域 ,以 右 侧 和 下 侧 的 黑 线 两 端 为 标准 ,可 画 出 4 条 直线 。9Patch 图 片 能 显示 内 容 的 区 
域 就 是 这 4 条 直线 所 围 的 中 间 区 域 ,其 中 包含 经 过 伸缩 的 变形 区 域 。 


=» Gs e 


4-17 一 个 作为 按钮 背景 的 9Patch 图 片 图 4-18 确定 伸缩 区 域 图 4-19 确定 显示 内 容 区 域 


2) 9Patch 图 片 与 一 般 PNG 图 片 的 比较 
通过 下 面 的 一 组 对 照 图 示 , 如 图 4-20 与 图 4-21 所 示 , 可 以 清楚 地 比较 出 图 . 9. png 与 
图 . png 的 区 别 。 


图 4-20 9Patch 图 片 经 过 拉 伸 后 与 原始 图 4-21 一 般 的 png 图 片 经 过 拉 伸 后 与 原始 
图 片 的 比较 图 片 的 比较 


Android 提供 了 一 个 制作 9Patch 图 片 的 工具 , 即 在 SDK 的 安装 文件 夹 的 tools 文件 夹 
下 ,可 以 找到 draw9patch. bat 文件 。 运 行 该 文件 即 可 打开 一 个 9Patch 图 制作 工具 ,利用 它 可 
以 将 一 个 普通 的 图 片 加 工 成 一 个 9Patch 图 片 。 


4.3.7 AnalogClock 和 DigitalClock 


在 Android 中 显示 时 钟 信息 的 有 AnalogClock 和 DigitalClock 两 个 控件 。 不 同 的 是 ， 
AnalogClock 以 模拟 时 钟 指针 的 形式 显示 时 间 , 且 只 有 时 针 和 分 针 , 而 DigitalClock 以 数字 形 
式 显示 时 间 ,可 以 精确 到 秒 。 它 们 都 位 于 android. widget 包 下 。 

【案例 4.11】 试 设计 如 图 4-22 所 示 的 布局 文件 片段 。 

【说 明 】 这 个 界面 使 用 了 两 种 控件 来 显示 时 间 信 息 ,一 
种 是 模拟 时 钟 的 ,一 种 是 以 数字 形式 的 ,它们 都 水 平 居 中 于 ”Eee 
屏幕 。 

【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 


1 <AnalogClock 

2 android:id- "(9 + id/analog" 

3 android:layout width- "wrap content" 
4 android:layout height = "wrap content" 
5 
6 


android:layout gravity = "center horizontal" 图 4-22 时钟 显示 效果 
/> <! -- 声明 一 个 AnalogClock 控件 --> 
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7 <DigitalClock 


8 android: id= "@ + id/digital" 

9 android:layout width- "wrap content" 

10 android:layout height = "wrap content" 

at android:layout gravity = "center horizontal" 
12 /> <! -- 声明 一 个 DigitalClock 控件 --» 


(1) 第 1—6 行 声明 了 一 个 AnalogClock 控件 ,并 水 平 居中 。 
(2) 第 7 一 12 行 声明 了 一 个 DigitalClock 控件 ,并 水 平 居中 。 


4.3.8 DatePicker 和 TimePicker 


日 期 和 时 间 是 任何 手机 都 会 有 的 基本 功能 。Android 也 不 例外 。Android 平台 用 
DatePicker 控件 来 显示 日 期 ,用 TimePicker 控件 来 显示 时 间 ,并 且 显 示 的 界面 非常 精致 漂亮 。 
1. 日 期 控件 
DatePicker 用 于 向 用 户 提供 包含 年 .月 .日 的 日 期 数据 ,并 允许 用 户 对 其 进行 修改 。 如 果 
用 户 对 日 期 进行 了 修改 ,需要 使 用 onDateChangedListener 监听 器 来 捕获 用 户 修改 的 日 期 数 
据 。DatePicker 继承 自 FrameLayout 类 。 其 主要 的 成 员 方 法 如 表 4-13 所 示 。 
表 4-13 DatePicker 类 的 主要 方法 及 说 明 


方 法 描 述 
getDayOfMonth() 获取 日 期 天 数 
getMonth() 获取 日 期 月 份 
getYear () 获取 日 期 年 份 
init (int year,int monthOfYear,int dayOfMonth, DatePicker. 初始 化 DatePicker 的 属性 ,以 onDateChangedListener 
OnDateChangedListener onDateChangedListener) 为 监听 器 对 象 ,负责 监听 日 期 数据 的 变化 
setEnabled(boolean enabled) 根据 传人 的 参数 设置 DatePicker 控件 是 否 可 用 
updateDate(int year,int monthOfYear,int dayOfMonth) ”根据 传人 的 参数 更 新 DatePicker 控件 的 各 个 属 

性 值 


【案例 4.12] 试 设计 如 图 4-23 所 示 的 布局 文件 片段 。 

【说 明 】 这 就 是 Android 的 DatePicker 控件 ,使 用 它 
既 可 以 显示 日 期 ,也 可 以 修改 日 期 。 因 为 它 继承 自 
FrameLayout 类 ,所 以 它 是 以 屏幕 的 左上 角 对 齐 方式 显 
示 的 。 

【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 


1 <DatePicker 


2 android: id="@ + id/date picker" 4-23. 日 期 选择 控件 的 显示 效果 
3 android:layout width- "wrap content" 

4 android:layout height = "wrap content" /> 

2. 时 间 控 件 


TimePicker 用 于 向 用 户 提供 一 天 中 的 时 间 , 可 以 是 24 小 时 制 , 也 可 以 为 AM/PM 制 ,并 
允许 用 户 对 其 进行 修改 。 如 果 要 捕获 用 户 修改 时 间 事 件 ,需要 添加 onTimeChangedListener 
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监听 器 对 TimePicker 进行 监听 。TimePicker 同样 继承 自 FrameLayout 类 。 其 常用 的 成 员 方 
法 如 表 4-14 所 示 。 


表 4-14 TimePicker 类 的 常用 方法 及 说 明 


方 法 描 g 
getCurrentHour () 获取 TimePicker 控件 的 当前 小 时 ,返回 Integer 对 象 
getCurrentMinute () 获取 TimePicker 控件 的 当前 分 钟 ,返回 Integer 对 象 
is24HourView () 判断 TimePicker 控件 是 否 为 24 小 时 制 
setCurrentHour (int currentHour) 设置 TimePicker 控件 的 当前 小 时 ,传人 Integer 对 象 
setCurrentMinute(int currentMinute) 设置 TimePicker 控件 的 当前 分 钟 ,传人 Integer 对 象 
setEnabled(boolean enabled) 根据 传人 的 参数 设置 TimePicker 控件 是 否 可 用 
setIs24 HourView( boolean is24HourView) 根据 传人 的 参数 设置 TimePicker 是 否 为 24 小 时 制 
setOnTimeChangedListener( TimePicker. 为 TimePicker 添加 OnTimeChangedListener 监听 器 


OnTimeChangedListener 


onTimeChangedListener) 


【案例 4.13】 试 设计 如 图 4-24 所 示 的 布局 文件 片段 。 


;局 文件 中 的 代码 片段 T. "TimePicker Activity 
【代码 】 布局 文件 中 的 代码 片段 如 下 所 示 。 
1 «TinePicker ea 
2 android:id- "(à + id/time picker" 
3 android:layout width- "wrap content" = 
4 android: layout_height = "wrap_content" /> 
j ene 图 4-24 时 间 选 择 控件 的 显示 效果 
4.4 简单 的 Ul 设计 案例 
A 


下 面 通过 一 个 应 用 项 目的 用 户 界面 设计 过 程 来 理解 本 章 前 三 节 所 介绍 的 主要 内 容 。 

【案例 4.14】 设计 一 个 “掌上 微 博 " 的 用 户 登 录 界 面 。 要 求 界面 友好 ,使 用 方便 。 

【说 明 】 通常 一 个 用 户 登 录 界 面 需要 有 这 样 三 个 方面 的 要 素 : 应 用 项 目的 名 称 , 用 户 的 
账号 与 密码 输入 “登录 "和 "注册 ”按钮 。 


应 用 项 目的 名 称 一 般 可 使 用 TextView 控件 显示 。 
用 户 的 账号 与 密码 输入 需要 用 TextView 控件 为 输入 区 作 提 示 , 还 需要 使 用 编辑 控件 
EditText, 让 用 户 可 以 进行 相关 信息 输入 ,还 要 注意 ,在 输入 密码 
应 用 标题 时 要 将 输入 的 信息 隐藏 。 
“登录 ”和 “注册 ”按钮 使 用 Button 控件 就 可 以 了 。 
为 了 界面 更 好 看 一 些 ,最 好 配 一 个 背景 图 作 装 饰 。 
为 了 统一 界面 的 文字 表述 ,需要 编写 字符 串 资源 文件 strings. xml; 
a- 为 了 统一 界面 风格 ,各 部 分 文本 的 字体 、 字 大 小 、 字 颜色 、 边 框 
ex e) 等 ,需要 编写 样式 文件 styles. xml, 
【布局 设计 过 程 】 
CD 绘 出 “掌上 微 博 "的 用 户 登 录 界 面 草图 。 在 本 书 中 使 用 的 
Android 模拟 器 屏幕 的 分 辩 率 是 320 X480 像素 , 按 此 比例 画 出 一 
图 4-25 用 户 登录 界面 规划 个 登录 界面 的 草图 如 图 4-25 所 示 。 其 中 和 矩形 表示 线性 布局 
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LinearLayout, 圆 角 和 矩形 表示 控件 。 
(2) 从 草图 中 得 出 以 下 设计 方案 。 
(D 一 个 外 层 LinearLayout。 
e. LinearLayout 背景 图 。 
避 为 纵向 排列 布局 。 
避 一 个 TextView 控件 显示 应 用 标题 ,三 个 LinearLayout t£, 
@ 应 用 标题 TextView 控件 。 
局 设置 宽度 为 full_parent, 高 度 为 文本 高 度 。 
名 设置 水 平 居中 对 齐 方 式 。 
名 设计 字体 颜色 与 字体 大 小 ,注意 与 背景 图 的 色彩 搭配 与 大 小 适中 。 
@ 账号 信息 LinearLayout。 
避 为 横向 排列 布局 。 
名 与 上 一 个 对 象 要 有 一 定 间距 。 


避 一 个 TextView 控件 显示 “账号 : ”, 左 对 齐 屏幕 ,并 且 设 置 适 当 的 宽度 值 。 


4 —^r EditText 控件 用 于 输入 账号 ,并且 设 置 适当 的 宽度 值 。 

© 密码 信息 LinearLayout. 

Cle fn B. LinearLayout 及 其 内 部 的 控件 属性 设置 基本 相同 。 

蕊 用 于 密码 输入 的 EditText 控件 ,要 设置 android. password 为 true, 
© 按钮 LinearLayout。 

避 为 横向 排列 布局 。 

总 与 父 布局 保持 一 定 间距 。 

忌 两 个 按钮 为 右 对 齐 方式 。 

忌 设 置 适 当 的 按钮 宽度 值 。 


(3) 在 Eclipse 中 创建 一 个 名 为 ZSWB_Loginl 的 Android 项 目 。 其 应 用 程序 名 为 


ZSWB, 包 名 为 cn. com. sgmsc. ZSWB, Activity 组 件 名 为 LoginlActivity. 
CD 将 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 
(5) 编写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 

2 «resources» 

3 < string name = "hello"» Hello World, ZSWB!«/string» 
4 < string name = "app_name"> 掌 上 微 博 </string> 

5 < string name = "ZSWB"> 掌 上 微 博 </string> 

6 < string name = "tvUid"> 账 号 : </string> 

7 < string name = "tvPwd"> 密 fij: </string> 

8 < string name = "btnLogin"> 登 录 </string> 

9 < string name = "btnReg"> 注 册 </string> 

10 </resources > 


(6) 在 res/values 目录 下 创建 名 为 styles. xml 样式 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


1 <?xml version - "1.0" encoding = "utf - 8"?» 

2 «resources? 

3 < style name = "title"> 

4 < item name = "android:textSize"» 32sp </item> 


91 


s 


92 


Nf 


Android 应 用 开发 教程 


17 
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(7) EMA res/layout 目录 下 的 main. xml 文件 为 long. xml, 并 编辑 之 。 


< item name = "android:textColor"># £37301 </item> 
< item name = "android:textStyle"» bold </item> 
</style> 
< style nane = "text"> 
< item name = "android: textSize"> 18sp </item> 
< item name = "android: textColor"># f37301 </item> 
< item name = "android: textStyle"> bold </item> 
</style> 
< style name = "button"> 
< item name = "android: textSize"> 20sp </item> 
< item name = "android: textColor"> # f37301 </item> 
< item name = "android: textStyle"> bold </item> 
</style> 
</resources > 


<?xml version = "1.0" encoding = "utf - 8"?> 

< LinearLayout 

xmlns:android = "http://schemas. android. com/apk/res/android" 
android:orientation = "vertical" 

android:layout width = "fill parent" 

android:layout height = "fill parent" 

android:gravity = "center horizontal" 

android:background = "(2 drawable/back" 

> <! -- 声明 垂直 分 布 的 线性 布局 -> 


< TextView 
android: id = "(à + id/TextView0" 
android: text = "(9 string/ZSWB" 
style = "@style/title" 
android: paddingTop = "20dip" 
android:paddingBottom = "20dip" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:gravity = "center" 
android:password = "false" 
> 

</TextView> 


<LinearLayout 
android:orientation = "horizontal" 
android: paddingTop = "25px" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
> 
< TextView 
android:text = "@string/tvUid" 
android:layout_width = "100px" 
style = "@style/text" 
android: layout_height = "wrap_content" 
android:layout gravity = "center vertical" 
/> 
< EditText 
android: id= "(9 + id/etUid" 


代码 如 下 所 示 。 
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40 android:singleLine = "true" 
41 android: layout_width = "150px" 
42 android: layout_height = "wrap content" 
43 ^ 
44 «/LinearLayout > 
45 
46 « LinearLayout 
47 android:orientation = "horizontal" 
48 android:layout width- "wrap content" 
49 android:layout height = "wrap content" 
50 android:layout gravity - "center horizontal" 
51 > 
52 < TextView 
53 android: text = "@string/tvPwd" 
54 style = "@style/text" 
55 android: layout_width = "100px" 
56 android:layout height = "wrap content" 
57 android:layout gravity = "center vertical" 
58 ^ 
59 < EditText 
60 android: id = "(à + id/etPwd" 
61 android: singleLine = "true" 
62 android: password = "true" 
63 android: layout_width = "150px" 
64 android:layout height = "wrap content" 
65 /> 
66 </LinearLayout > 
67 
68 < LinearLayout 
69 android:paddingTop = "20dip" 
70 android: paddingBottom = "20dip" 
Ti android: paddingRight = "20dip" 
72 android:orientation = "horizontal" 
73 android:gravity = "right" 
74 android:layout width- "fill parent" 
35 android:layout height = "wrap content" 
76 > <! -- 声明 于 显示 按钮 的 线性 布局 --» 
77 « Button 
78 android: id = "(à + id/btnLogin" 
79 android:text = "(4 string/btnLogin" 
80 style = "(Qstyle/button" 
81 android:minWidth = "70dip" 
82 android:layout width- "wrap content" 
83 android:layout height = "wrap content" 
84 /> 
85 < Button 
86 android:id- "(9 + id/btnReg" 
87 android: text = "(9 string/btnReg" 
88 style = "@style/button" 
89 android:minWidth = "70dip" 
90 android:layout width- "wrap content" 
91 android:layout height = "wrap content" 
92 /> 
93 </LinearLayout > 
94 


95 </LinearLayout > 


(D 第 2 一 9 行 声 明 一 个 外 层 的 LinearLayout 布局 。 其 中 第 8 行 设 置 了 一 个 背景 图 ,该 背 
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景 图 片 取 自 于 res/drawable-mdpi 目录 中 的 back. jpg 文件 。 

@ $ 11—22 行 声明 一 个 TextView 控件 用 于 显示 应 用 标题 。 其 中 ,第 13 行为 控件 设置 
显示 的 内 容 , 其 内 容 取 自 字 符 串 资源 文件 strings. xml 中 名 为 “ZSWB” 的 内 容 ; 第 14 行 设置 控 
件 文本 显示 风格 ,其 文本 风格 由 样式 文件 styles. xml 中 名 为 “title” 的 样式 所 定义 ; 第 15 行 和 
第 16 行 设置 该 控件 与 其 相 邻 的 上 、 下 控件 的 间距 为 20 像素 。 

© 第 24 一 44 行 声明 了 一 个 内 嵌 的 LinearLayout 布局 。 其 中 ,第 31—37 行 声 明了 一 个 
TextView 控件 ,其 显示 的 文本 取 自 于 字符 串 资源 文件 strings. xml 中 名 为 “tvUid” 的 内 容 , 文 
本 显示 风格 由 样式 文件 styles. xml 中 名 为 “text” 的 样式 所 定义 ; 第 38 一 43 行 声 明了 一 个 
EditText 控件 ,第 40 行 设置 该 EditText 为 单行 的 编辑 框 。 

CD $ 46— 66 TERTBAK RR LinearLayonut 布 
局 。 其 中 ,第 59 一 65 行 声明 了 一 个 输入 密码 的 EditText f$ 
件 ,第 62 行 设 置 该 EditText 为 password 为 true 的 编辑 框 。 

加 第 68 一 93 行 声明 了 第 三 个 内 由 的 LinearLayonut 布 
局 。 其 中 ,声明 了 两 个 Button 控件 ,第 81 (1.58 89 行 分 别 设 
置 这 两 个 Button 的 最 小 宽度 为 70 像素 ,以 确保 按钮 上 的 文本 
能 显示 完整 。 

由 于 本 例 只 是 在 为 “掌上 微 博 ”的 用 户 登 录 界 面 作 设 计 ， 
并 没有 做 任何 实质 性 的 代码 编写 工作 ,所 以 就 不 用 编写 项 目 
的 代码 文件 和 AndroidManifest. xml 文件 了 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 ZSWB_Loginl 项 目 。 运 行 结果 如 图 4-26 所 示 。 


图 4-26 “掌上 微 博 " 用 户 登 录 界 面 


小 结 


本 章 简单 介绍 了 Android 应 用 程序 用 户 界面 的 所 有 控件 的 基 类 View 和 所 有 容器 类 的 基 
类 ViewGroup。 详 细 介绍 了 Android 的 5 种 布局 类 ,以 及 11 个 Android 的 基本 控件 类 。 分 别 
通过 布局 描述 文件 对 这 些 常 用 的 布局 类 和 基本 控件 类 的 属性 及 其 方法 进行 举例 说 明 。 最 后 通过 
一 个 实用 程序 的 用 户 登录 界面 设计 过 程 , 为 读者 演示 一 个 应 用 的 用 户 界面 是 怎样 创建 出 来 的 。 

是 否 熟练 地 掌握 了 这 些 布 局 和 基本 控件 的 XML 描述 方法 就 能 够 开发 出 各 种 各 样 的 用 户 
界面 了 呢 ? 回答 是 : 否 。 还 有 一 些 屏幕 元 素 如 各 类 视图 、 选 项 卡 、 进 度 条 等 控件 。 是 否 所 有 的 
用 户 界面 都 只 需要 在 其 布局 文件 中 进行 描述 ,而 不 需要 在 代码 文件 中 进行 定义 呢 ? 答案 也 是 : 
否 。 有 些 控 件 还 必须 结合 相关 的 代码 才能 定义 完全 。 这 些 知 识 将 在 第 5 章 中 介绍 ,请 继续 学 习 。 


练习 


1. 设计 一 个 自己 微 博 的 登录 界面 ,要 求 有 “账号 ”和 “密码 ”两 个 输入 编辑 框 ,有 “登录 ”和 
“注册 ”两 个 按钮 。 

2. 设计 一 个 自己 微 博 的 注册 界面 ,要 求 至 少 有 “账号 昵称 ”“ 密 码 ”“ 确 认 密 码 ” 等 输入 编 
辑 框 ,有 “注册 ”和 “返回 ”两 个 按钮 。 
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Android 应 用 程序 用 户 界面 的 各 控件 仅 能 被 用 户 看 到 , 那 是 “ 死 " 的 东西 ,只 有 它们 与 用 户 
进行 交互 ,触发 了 新 的 动作 发 生 , 那 么 ,应 用 程序 就 活 了 。 例 如 , 单 击 一 个 按钮 ,进入 了 另 一 个 
界面 。 或 者 , 单 击 了 下 拉 框 ,出 现 若干 选项 供 选择 。 又 或 者 ,图 片 或 文本 开始 像 走马 灯 似 的 动 
起 来 等 。 因 此 ,在 开发 中 ,不 仅 要 会 在 布局 文件 中 描述 UI, 还 必须 在 代码 文件 中 做 些 工作 , 才 
能 得 到 一 个 “活着 ”的 应 用 程序 。 

本 章 将 介绍 的 控件 ,都 需要 结合 一 定 的 代码 编程 ,才能 看 到 其 使 用 时 的 完整 效果 。 在 介绍 
它们 之 前 , 先 来 学 习 Android 系统 的 事件 处 理 机 制 。 


6.1 Android 事件 处 理 机 制 


在 Android 平台 上 ,对 事件 的 处 理 机 制 有 两 种 : 一 种 是 基于 回调 机 制 的 事件 处 理 , 另 一 种 
是 基于 监听 接口 的 事件 处 理 。 


5.1.1 基于 回调 机 制 的 事件 处 理 


回调 机 制 实质 就 是 将 事件 的 处 理 绑 定 在 控件 上 ,由 图 形 用 户 界面 控件 自己 处 理事 件 ,回调 
机 制 需 要 自 定义 View 来 实现 。 回 调 不 是 由 该 方法 的 实现 方 直接 调用 ,而 是 在 特定 的 事件 或 
条 件 发 生 时 ,由 另外 的 一 方 通过 一 个 接口 来 调用 ,用 于 对 该 事件 或 条 件 进行 响应 。 

在 Android 平台 中 ,每 个 View 都 有 自己 的 处 理事 件 的 回调 方法 ,开发 人 员 可 以 通过 重 写 
View 中 的 这 些 回 调 方法 来 实现 需要 的 响应 事件 。 当 某 个 事件 没有 被 任何 一 个 View 处 理 时 ， 
便 会 调用 Activity 中 相应 的 回调 方法 。 

View 类 提供 了 许多 公用 的 捕获 用 户 在 界面 上 触发 事件 的 回调 方法 ,为 了 捕获 和 处 理事 
件 , 必 须 继 承 某 个 类 (如 View 类 ) ,并重 写 这 些 方法 ,以 便 开发 者 自己 定义 具体 的 处 理 逻 辑 代 
码 。 下 面 介 绍 一 些 常见 的 回调 方法 。 


1. onKeyDown() 方 法 


几乎 所 有 的 View 都 有 onKeyDown() 方 法 ,该 方法 用 来 捕捉 手机 键盘 被 按 下 的 事件 。 该 
方法 是 接口 KeyEvent. Callback 中 的 抽象 方法 ,所 有 的 View 全 部 实现 了 该 接口 并 重 写 了 该 
方法 。 

onKeyDown() 方 法 声明 格式 : 


public boolean onKeyDown (int keyCode, KeyEvent event) 
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1) 参数 说 明 

COD. 参数 keyCode: 该 参数 为 int 类 型 ,表示 被 按 下 的 键 值 ( 即 键盘 码 )。 手 机 键盘 中 每 个 
键 都 会 有 其 单独 的 键盘 码 ,在 应 用 程序 中 都 是 通过 键盘 码 才 知道 用 户 按 下 的 是 哪个 键 。 注 意 ， 
不 同型 号 的 手机 中 , 键 值 可 能 不 同 。 

(2) 参数 event: 该 参数 为 按键 事件 的 对 象 ,其 中 包含 触发 事件 的 详细 信息 ,例如 事件 的 
状态 .事件 的 类 型 .事件 发 生 的 时 间 等 。 当 用 户 按 下 按键 时 ,系统 会 自动 将 事件 封装 成 
KeyEvent 对 象 供应 用 程序 使 用 。 

2) 返回 值 

该 方法 的 返回 值 为 一 个 boolean 类 型 的 变量 。 当 返回 true 时 ,表示 已 经 完整 地 处 理 了 这 
个 事件 ,并 不 希望 其 他 的 回调 方法 再 次 进行 处 理 ; 而 当 返回 false 时 ,表示 并 没有 完全 处 理 完 
该 事件 ,更 希望 其 他 回调 方法 继续 对 其 进行 处 理 , 例 如 Activity 中 的 回调 方法 。 


2. onKeyUp0 〇 方法 


onKeyUp() 方 法 用 来 捕捉 手机 键盘 按键 抬 起 的 事件 。 该 方法 同样 是 接口 KeyEvent. 
Callback 中 的 一 个 抽象 方法 ,并且 所 有 的 View 同样 全 部 实现 了 该 接口 并 重 写 了 该 方法 。 
onKeyUp() 方 法 声明 格式 : 


public boolean onKeyUp (int keyCode, KeyEvent event) 


onKeyUp() 方 法 的 参数 与 返回 值 与 onKeyDown O Jr ik Fl Is] . fe I 4s f EX 
该 方法 的 使 用 方法 与 onKeyDown() 基 本 相同 ,只 是 该 方法 会 在 按键 抬 起 时 被 调用 。 如 果 
用 户 需要 对 按键 抬 起 事件 进行 处 理 , 通 过 重 写 该 方法 即 可 以 实现 。 


3. onTouchEvent() 方 法 


onTouchEvent() 方 法 用 来 处 理 手 机 屏幕 的 触摸 事件 。 该 方法 在 View 类 中 有 定义 ,并 且 
所 有 的 View 子 类 全 部 重 写 了 该 方法 。 
onTouchEvent() 方 法 声明 格式 : 


public boolean onTouchEvent (MotionEvent event) 


参数 说 明 : 

参数 event: 为 手机 屏幕 触摸 事件 封装 类 的 对 象 ,其 中 封装 了 该 事件 的 所 有 信息 ,例如 触 
摸 的 位 置 .触摸 的 类 型 以 及 触摸 的 时 间 等 。 该 对 象 会 在 用 户 触摸 手机 屏幕 时 被 创建 。 

该 方法 的 返回 值 机 理 与 键盘 响应 事件 的 相同 ,在 此 不 作 袭 述 。 

该 方法 并 不 像 之 前 介绍 过 的 方法 只 处 理 一 种 事件 ,一 般 情况 下 以 下 三 种 情况 的 事件 全 部 
由 onTouchEvent() 方 法 处 理 , 只 是 三 种 情况 中 的 动作 值 不 同 。 

CD 屏幕 被 按 下 : 当 屏 幕 被 按 下 时 ,会 自动 调用 该 方法 来 处 理事 件 , 此 时 MotionEvent. 
getAction() 的 值 为 MotionEvent. ACTION DOWN ,如 果 在 应 用 程序 中 需要 处 理 屏幕 被 按 下 
的 事件 ,只 需 重 写 该 回调 方法 ,然后 在 方法 中 进行 动作 的 判断 即 可 。 

(2) 屏幕 被 抬 起 : 当 触 控 笔 离开 屏幕 时 触发 的 事件 ,该 事件 同样 需要 on TouchEvent O77 
法 来 捕捉 ,然后 在 方法 中 进行 动作 判断 。 当 MotionEvent. getAction() 的 值 为 MotionEvent. 
ACTION_UP 时 ,表示 是 屏幕 被 抬 起 的 事件 。 

(3) 在 屏幕 中 拖 动 : 该 方法 还 负责 处 理 触 控 笔 在 屏幕 上 滑动 的 事件 ,同样 是 调用 
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MotionEvent, getAction( ) 方 法 来 判断 动作 值 是 否 为 MotionEvent. ACTION. MOVE 再 进行 
处 理 。 

下 面 通过 一 个 简单 的 案例 介绍 手机 屏幕 的 触摸 事件 。 

【案例 5.1】 在 屏幕 区 域内 触摸 滑动 ,捕捉 按 下 、 抬 起 事件 的 状态 ,滑动 的 坐标 , 触 点 压 
力 , 触 点 的 大 小 等 信息 。 

【说 明 】 在 Java 代码 中 ,有 一 系列 的 get...0 〇 方法 可 用 。 在 此 例 中 需要 用 到 下 列 方法 。 

(1) 使 用 MotionEvent. getAction() 方 法 来 获取 屏幕 被 按 下 等 事件 的 状态 。 

(2) 使 用 Event. getX() „Event. getY() 方 法 来 获取 触 点 坐标 值 。 

(3) 使 用 Event. getPressure() 方 法 来 获取 触 屏 压 力 大 小 。 

(4) 使 用 Event. getSize() 方 法 来 获取 触 点 尺寸 。 

【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity Touch 的 Android 项 目 。 其 应 用 程 
序 名 为 “Touch”, 包 名 为 cn. com. sgmsc. touch. Activity 组 件 名 为 TouchActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?> 
2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android: background = " # FFOOFF" 

5 android:layout width- "fill parent" 

6 android:layout height = "fill parent"» 

7 X TextView 

8 android: id = "(à + id/touch area" 

9 android:layout width- "fill parent" 
10 android:layout height = "360dip" 

11 android: text = "触摸 事件 测试 区 " 

12 android:textColor = " # 99FFFF" 

13 /> 

14 < TextView 

15 android:id- "(9 + id/event label" 

16 android:layout width- "fill parent" 
13 android:layout height = "wrap content" 
18 android:text = "触摸 事件 : " 

19 android:textColor = " # FFFFFF" 

20 /> 


21 </LinearLayout > 


(D 第 7 一 13 行 声明 了 一 个 TextView 控件 。 为 了 在 触摸 滑动 时 将 相关 的 信息 显示 在 屏幕 
下 方 , 所 以 在 第 10 行 设置 TextView 的 高 为 360dip。 

© 第 14 一 20 行 声明 另 一 个 TextView 控件 。 该 控件 的 资源 id 为 “event_label”。 

(3) 开发 逻辑 代码 : 打开 src/cn. com. sgmsc. touch 包 下 的 TouchActivity. java 文件 ,并 
编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgnsc. touch; 


import android. app. Activity; 
import android. os. Bundle; 

import android. view. MotionEvent; 
import android. widget. TextView; 
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* 

8 public class TouchActivity extends Activity ( 

9 

10 private TextView eventlable; 

11 

12 (2 Override 

13 public void onCreate(Bundle savedInstanceState) { 

14 super. onCreate(savedInstanceState); 

15 setContentView(R. layout. main); 

16 eventlable = (TextView) findViewById(R. id. event label); 

17 ) 

18 

19 @Override 

20 public boolean onTouchEvent(MotionEvent event) { 

21 int action = event.getAction(); 

22 switch (action) { 

23 // 当 按 下 的 时 候 

24 case (MotionEvent. ACTION DOWN): 

25 Display("ACTION DOWN", event); 

26 break; 

27 // 当 抬 起 的 时 候 

28 case (MotionEvent. ACTION UP): 

29 Display("ACTION UP", event); 

30 break; 

31 // 当 触摸 的 时 候 

32 case (MotionEvent. ACTION MOVE): 

33 Display("ACTION MOVE", event); 

34 ) 

35 return super. onTouchEvent( event) ; 

36 } 

37 

38 public void Display(String eventType, MotionEvent event) { 

39 // 获 取 触 点 相对 坐标 的 信息 

40 intx = (int) event.getX(); 

4l int y = (int) event.getY(); 

42 // 获 取 触 屏 压 力 大 小 

43 float pressure = event.getPressure(); 

44 // 获 取 触 点 尺寸 

45 float size = event.getSize(); 

46 // 变 量 msg 存放 显示 信息 

47 String msg = ""; 

48 msg += "事件 类 型 : ”+ eventType + "Wn"; 

49 msg += "坐标 (x ，yY) : " + String.valueOf(x) + ", " + String.valueOf(y) + "Wn"; 

50 msg += " 触 点 压力 : ”+ String.valueOf(pressure) + "Wn"; 

51 msg += " 触 点 尺寸 : ”+ String.valueOf(size) + "Wn"; 

52 eventlable. setText(msg) ; 

53 } 

54 

55 } 

(D 58 5 行 引入 android. view. MotionEvent 类 ,因为 在 代码 中 将 使 用 到 触摸 滑动 类 的 
对 象 。 


© 第 6 行 引 入 android. widget. TextView 类 ,因为 在 代码 中 要 给 一 个 TextView 类 对 象 
赋值 。 
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© 第 10 行 声明 一 个 TextView 类 对 象 ,名 为 “eventlabel”。 

团 第 12 一 17 行 重 写 onCreate() 方 法 。 在 第 16 行为 eventlabel 对 象 实例 化 ,即将 资源 中 
ID 号 为 event_label 的 TextView 对 象 赋予 变量 eventlabel 中 。 

© 第 19 一 36 行 重 写 onTouchEvent() 方 法 。 在 该 方法 中 ,event 参数 是 一 个 MotionEvent 
对 象 。 第 21 行 ,通过 getAction() 方 法 来 获取 事件 的 状态 ,并 将 返回 结果 赋予 整 型 变量 
action 中 。 

© 第 22—34 行 是 一 组 switch-case 语句 ,根据 action 中 的 不 同 值 ,将 不 同 的 参数 传 入 自 
定义 的 Display() 方 法 中 。 例 如 , 当 action 值 为 “MotionEvent. ACTION_DOWN” 时 ,调用 方 
法 Display("ACTION_DOWN"，event); 当 action 值 为 "MotionEvent. ACTION_UP” 时 , 调 
用 方法 Display("ACTION_UP"，event); 当 action fii Jj " MotionEvent. ACTION. MOVE" 
时 ,调用 方法 Display " ACTION. MOVE", event), 

(D 58 38—53 行 定义 了 Display() 方 法 。 该 方法 通过 
onTouchEvent() 方 法 调用 ,在 该 方法 中 获取 触 屏 事件 的 状态 、 
触 点 坐标 、 触 点 尺寸 等 信息 ,并 且 显 示 在 eventlabel 对 象 中 。 

【运行 结果 】〗 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 Activity Touch 项 目 。 运 行 结果 如 图 5-1 所 示 。 
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4. onTrackballEvent O 77 ;& 


onTrackballEvent() 方 法 用 来 处 理 手机 中 的 轨迹 球 事件 。 
所 有 的 View 同样 全 部 实现 了 该 方法 。 


onTrackballEvent() 方 法 声明 格式 : n 

public boolean onTrackballEvent (MotionEvent event) 

参数 说 明 ; 图 5-1 在 手机 屏幕 内 触摸 滑动 
参数 event: 为 手机 轨迹 球 事件 封装 类 的 对 象 ,其 中 封装 及 相关 信息 


了 触发 事件 的 详细 信息 ,同样 包括 事件 的 类 型 .触发 时 间 等 。 
一 般 情况 下 ,该 对 象 会 在 用 户 操控 轨迹 球 时 被 创建 。 

该 方法 的 返回 值 与 前 面 介 绍 的 各 个 回调 方法 的 返回 值 机 制 完 全 相同 «TE CAS E DER o 

该 方法 的 使 用 方法 与 前 面 介绍 过 的 各 个 回调 方法 基本 相同 ,可 以 在 Activity 中 重 写 该 方 
法 ,也 可 以 在 各 个 View 的 实现 类 中 重 写 。 

在 手机 中 使 用 轨迹 球 , 可 以 使 用 户 操 作 达 到 更 好 的 效果 。 因 为 使 用 轨迹 球 有 如 下 特点 。 

(1) 某 些 型 号 的 手机 设计 出 的 轨迹 球 会 比 只 有 手机 键盘 时 更 美观 。 

(2) 轨迹 球 使 用 更 为 简单 。 

(3) 使 用 轨迹 球 会 比 键盘 更 为 细 化 ,因为 滚动 轨迹 球 时 ,后 台 的 表示 状态 的 数值 会 变化 得 
更 细微 更 精准 。 

如 果 想 在 Android 模拟 器 中 实现 轨迹 球 操作 ,可 以 通过 Fo 键 打开 模拟 器 的 轨迹 球 ,然后 
便 可 以 通过 鼠标 的 移动 来 模拟 轨迹 球 事件 了 。 


5. onFocusChanged() 方 法 


onFocusChanged() 方 法 用 来 处 理 焦 点 改变 的 事件 。 前 面 介绍 的 各 个 方法 都 可 以 在 View 
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及 Activity 中 重 写 ,但 onFocusChanged() 只 能 在 View 中 重 写 。 当 某 个 控件 重 写 了 该 方法 后 ， 
当 焦 点 发 生变 化 时 ,会 自动 调用 该 方法 来 处 理 焦点 改变 的 事件 。 
onFocusChanged() 方 法 声明 格式 : 


protected void onFocusChanged (boolean gainFocus, int direction, Rect previouslyFocusedRect) 


参数 说 明 : 

(1) 参数 gainFocus: 表示 触发 该 事件 的 View 是 否 获 得 了 焦点 , 当 该 控件 获得 焦点 时 ， 
gainFocus 等 于 true, 否 则 等 于 false, 

(2) 参数 direction: 表示 焦点 移动 的 方向 ,用 数值 表示 ,有 兴趣 的 读者 可 以 重 写 View 中 
的 该 方法 打印 该 参数 进行 观察 。 

(3) 参数 previouslyFocusedRect: 表示 在 触发 事件 的 View 的 坐标 系 中 ,前 一 个 获得 焦点 
的 矩形 区 域 , 即 表示 焦点 是 从 哪里 来 的 。 如 果 不 可 用 则 为 null。 

该 方法 没有 返回 值 。 

在 图 形 用 户 界面 中 ,焦点 描述 了 按键 事件 (或 者 是 屏幕 事件 ) 的 承受 者 ,每 次 按键 事件 都 发 
生 在 拥有 焦点 的 View 上 。 在 应 用 程序 中 ,可 以 对 焦点 进行 控制 ,例如 从 一 个 View 移动 到 另 
一 个 View。 下 面 列 出 一 些 与 焦点 有 关 的 常用 方法 ,如 表 5-1 所 示 。 


表 5-1 与 焦点 有 关 的 常用 方法 及 说 明 


5 法 Hx 
setFocusable (boolean) 设置 View 是 否 可 以 拥有 焦点 
isFocusable () 监测 此 View 是 否 可 以 拥有 焦点 
setNextFocusDownld (int) 设置 View 的 焦点 向 下 移动 后 获得 焦点 View 的 ID 
hasFocus () 返回 了 View 的 父 控件 是 否 获得 了 焦点 
requestFocus () 尝试 让 此 View 获得 焦点 
在 触摸 模式 下 ,设置 View 控件 是 否 可 以 拥有 焦点 。 默 认 情况 下 是 不 


isFocusableTouchMode () 
isFocusableTouc le 能 的 


5.1.2 基于 监听 接口 的 事件 处 理 


在 Android 系统 中 引用 Java 中 的 事件 监听 处 理 机 制 , 它 包 括 事件 .事件 源 和 事件 监听 器 
三 个 方面 。 事 件 可 以 是 鼠标 事件 ,键盘 事件 触摸 事件 或 鼠标 移动 事件 等 ; 事件 源 是 指 产生 事 
件 的 控件 ; 事件 监听 器 是 控件 产生 事件 时 响应 的 接口 ,根据 事件 的 不 同 重 写 不 同 的 事件 处 理 
方法 来 处 理事 件 。 例 如 ,一 辆 轿车 上 安装 了 防盗 设备 , 当 轿 车 被 外 力 引起 强烈 震动 时 就 会 报 
警 。 这 时 ,震动 好 比 事件 ,轿车 好 比 事件 源 , 报 警 器 好 比 事件 监听 器 。 


1. Android 的 监听 事件 处 理 模 型 


对 于 一 个 Android 应 用 程序 来 说 ,事件 处 理 是 必 不 可 少 的 ,用 户 与 应 用 程序 之 间 的 交互 便 
是 通过 事件 处 理 来 完成 的 。 在 Android 的 监听 事件 处 理 模 型 中 涉及 以 下 内 容 。 

1) 事件 源 与 事件 

在 应 用 程序 中 ,各 个 控件 在 不 同情 况 下 触发 的 事件 不 尽 相同 ,因此 ,产生 的 事件 也 可 能 
不 同 。 
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2) 事件 监听 器 

事件 监听 器 则 是 用 来 处 理事 件 的 对 象 ,实现 了 特定 的 接口 ,根据 事件 的 不 同 重 写 不 同 的 事 
件 处 理 方法 来 处 理事 件 。 

3) 事件 源 与 事件 监听 器 

当 用 户 与 应 用 程序 交互 时 ,一 定 是 通过 触发 某 些 事件 来 完成 的 ,让 事件 来 通知 程序 应 该 执 
行 哪些 操作 ,此 过 程 主 要 涉及 事件 源 与 事件 监听 器 。 将 事件 源 与 事件 监听 器 联系 到 一 起 ,就 需 
要 为 事件 源 注册 监听 , 当 事 件 发 生 时 ,系统 才 会 自动 通知 事件 监听 器 来 处 理 相应 的 事件 。 

在 Android 中 为 相应 接口 设置 监听 器 对 象 方法 是 使 用 一 系列 的 set sx Listener() ,为 指 
定 的 View 对 象 设置 为 *** 事件 接口 的 监听 器 。 例 如 ,为 Button 对 象 的 OnClick 事件 接口 设 
置 监听 器 使 用 setOnClickListener() 方 法 ,为 在 触 屏 区 域 的 某 个 View 对 象 的 OnTouch 事件 
接口 设置 监听 器 使 用 setOnTouchListener() 方 法 ,等 等 。 

事件 处 理 的 过 程 一 般 分 为 以 下 三 步 。 

(1) 为 事件 源 对 象 添加 监听 对 象 。 这 样 当 某 个 事件 被 触发 时 ,系统 才 会 知道 通知 谁 来 处 
理 该 事件 。 

(2) 当 事 件 发 生 时 ,系统 会 将 事件 封装 成 相应 类 型 的 事件 对 象 ,并 发 送 给 注册 到 事件 源 的 
事件 监听 器 对 象 。 

(3) 当 监听 器 对 象 接收 到 事件 对 象 之 后 ,系统 会 调用 监听 器 中 相应 的 事件 处 理 方法 来 处 
理事 件 并 给 出 响应 。 


2. 监听 器 接口 与 回调 方法 


正如 Java 中 的 监听 处 理 模型 一 样 ,Android 也 提供 了 同样 的 基于 监听 接口 的 事件 处 理 
模型 。 

1) OnClickListener 接口 

CD 功能 。 

该 接口 处 理 的 是 单 击 事件 。 单 击 事件 包括 : 在 触 控 模式 下 ,在 某 个 View 上 按 下 并 抬 起 的 
组 合 动作 ; 而 在 键盘 模式 下 , 某 个 View 获得 焦点 后 单 击 “ 确 定 ” 键 或 者 按 下 轨迹 球 事件 。 

(2) 对 应 的 回调 方法 。 


public void onClick(View v) 


说 明 . 

(D 需要 实现 onClick() 方 法 。 

@ 参数 v 便 为 事件 发 生 的 事件 源 。 

2) OnLongClickListener 接口 

(1) 功能 。 

OnLongClickListener 接口 与 之 前 介绍 的 OnClickListener 接口 原理 基本 相同 ,只 是 该 接 
FH View 长 按 事件 的 捕捉 接口 , 即 当 长 时 间 按 下 某 个 View 时 触发 的 事件 。 

CD 对 应 的 回调 方法 。 


public boolean onLongClick(View v) 


说 明 : 
(D 需要 实现 onLongClick() 方 法 。 
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@ 参数 v 为 事件 源 控件 , 当 长 时 间 按 下 此 控件 时 才 会 触发 该 方法 。 

@ 返回 值 : 该 方法 的 返回 值 为 一 个 boolean 类 型 的 变量 , 当 返 回 true 时 ,表示 已 经 完整 地 
处 理 了 这 个 事件 ,并 不 希望 其 他 的 回调 方法 再 次 进行 处 理 ; 当 返 回 false 时 ,表示 并 没有 完全 
处 理 完 该 事件 ,更 希望 其 他 方法 继续 对 其 进行 处 理 。 

3) OnFocusChangeListener 接口 

(1) 功能 。 

OnFocusChangeListener 接口 用 来 处 理 控 件 焦点 发 生 改 变 的 事件 。 如 果 注 册 了 该 接口 ， 
当 某 个 控件 失去 焦点 或 者 获得 焦点 时 都 会 触发 该 接口 中 的 回调 方法 。 

(2) 对 应 的 回调 方法 。 


public void onFocusChange(View v, Boolean hasFocus) 


说 明 : 

CD 需要 实现 onFocusChange() 方 法 。 

@ 参数 v 便 为 触发 该 事件 的 事件 源 。 

© 参数 hasFocus 表示 v 的 新 状态 , 即 v 是 否 获得 焦点 。 

4) OnKeyListener 接口 

(1) 功能 。 

OnKeyListener 是 对 手机 键盘 进行 监听 的 接口 ,通过 对 某 个 View 注册 该 监听 , 当 View 
获得 焦点 并 有 键盘 事件 时 , 便 会 触发 该 接口 中 的 回调 方法 。 

(2) 对 应 的 回调 方法 。 


public boolean onKey(View v, int keyCode, KeyEvent event) 


说 明 : 

CD 需要 实现 onKey() 方 法 。 

@ 参数 v 为 事件 的 事件 源 控件 。 

© 参数 keyCode 为 手机 键盘 的 键盘 码 。 

@ 参数 event 便 为 键盘 事件 封装 类 的 对 象 ,其 中 包含 事件 的 详细 信息 ,例如 发 生 的 事件 、 
事件 的 类 型 等 。 

5) OnTouchListener 接口 

(1) 功能 。 

OnTouchListener 接口 是 用 来 处 理 手机 屏幕 事件 的 监听 接口 , 当 在 View 的 范围 内 发 生 触 
摸 按 下 、 抬 起 或 滑动 等 动作 时 都 会 触发 该 事件 。 

(2) 对 应 的 回调 方法 。 


public boolean onTouch(View v, MotionEvent event) 


D 

CD 需要 实现 onTouch() 方 法 。 对 应 接口 的 回调 方法 。 这 个 方法 还 处 理 触摸 事件 的 调用 ， 
包括 在 屏幕 上 按 下 ,释放 和 移动 手势 时 调用 。 

@ 参数 v 同样 为 事件 源 对 象 。 

@ 参数 event 为 事件 封装 类 的 对 象 ,其 中 封装 了 触发 事件 的 详细 信息 ,同样 包括 事件 的 
类 型 .触发 时 间 等 信息 。 
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6) OnCreateContextMenuListener 接口 

(1) 功能 。 

OnCreateContextMenuListener 接口 是 用 来 处 理 上 下 文 菜单 显示 事件 的 监听 接口 。 该 方 
法 是 定义 和 注册 上 下 文 菜单 的 另 一 种 方式 。 

(2) 对 应 的 回调 方法 。 


public void onCreateContextMenu( ContextMenu menu, View v, ContextMenuInfo info) 


WH: 

O 需要 实现 onCreateContextMenu() 方 法 。 

© 参数 menu 为 事件 的 上 下 文 菜单 。 

© 参数 v 为 事件 源 View, 当 该 View 获得 焦点 时 才 可 能 接收 该 方法 的 事件 响应 。 

@ 参数 info 对 象 中 封装 了 有 关上 下 文 菜单 额外 的 信息 ,这 些 信息 取决 于 事件 源 View. 

该 方法 会 在 某 个 View 中 显示 上 下 文 菜单 时 被 调用 ,开发 人 员 可 以 通过 实现 该 方法 来 处 
理 上 下 文 菜单 显示 时 的 一 些 操作 。 其 使 用 方法 与 前 面 介绍 的 各 个 监听 接口 没有 任何 区 别 。 


3. 事件 监听 器 接口 的 实现 方法 


其 实 这 涉及 一 些 Java 基础 知识 ,主要 是 接口 的 一 些 实现 方法 。 对 于 事件 监听 器 的 实现 ， 
有 以 下 三 种 方式 。 

CD 在 构造 方法 中 使 用 匿名 内 部 类 实现 事件 监听 器 接口 。 通 常 在 Activity 组 件 的 
onCreate 事件 中 直接 定义 ,直接 动作 。 其 代码 片段 如 下 。 


@override 
public void onCreate(Bundle savedInstanceState) { 


Button buttonl 


1 

2 

3 

4 (Button)findViewById(R. id. myButtonl); 
5 Button button2 

6 

了 

8 


= (Button)findViewById(R. id. myButton2); 
// 注 册 事件 监听 
button1. setOnClickListener(new View.OnClickListener() { 
9 // 匿 名 内 部 类 实现 事件 监听 器 接口 
10 @Override 
11 public void onClick(View v) { 


12 m // 执 行 某 些 操作 
13 
14 p; 


15 Button2.setOnClickListener(new View.OnClickListener() { 
16 // 实 现 方法 : 匿名 内 部 类 实现 事件 监听 器 接口 

17 (QOverride 

18 public void onClick(View v) ( 


i ih // 执 行 某 些 操作 
20 } 

21 )) 

22 

23. Í 


这 种 方式 每 个 控件 都 定义 一 次 ,通常 比较 不 方便 。 
(2) 外 部 类 实现 事件 监听 器 接口 。 通 常 是 在 Activity 组 件 中 实现 其 接口 。 其 代码 片段 
AF. 
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1 public class TestMedia extends Activity implements View.OnClickListener( 
2 

3 (Q override 

4 public void onCreate(Bundle savedInstanceState) ( 

5 - 

6 Button btnl = (Button) findViewById(R. id. myButtonl); 
7 Button btn2 = (Button) findViewById(R. id. myButton2); 
8 

9 btnl .setOnClickListener(); 

10 btn2 .setOnClickListener(); 

XY 

12 } 

13 


14 // 实 现 多 个 按钮 的 onClick() 方 法 
15 @override 
16 public void onClick(View v) { 


17 switch (v.getId()) ( 

18 case R. id. myButtonl: 

19 - //do something 
20 break; 

21 case R. id. myButton2: 

22 - //do something 
23 break; 

24 ) 

25 ) 

26 } 


这 种 在 Activity 组 件 中 实现 其 接口 ,可 以 让 多 个 外 部 控件 共享 一 个 接口 , 即 多 个 控件 可 以 
用 一 个 onClick() 方 法 来 定义 它们 的 回调 操作 。 这 样 相对 较 方便 。 
(3) 内 部 类 实现 事件 监听 器 接口 。 第 三 种 类 似 第 二 种 ,其 代码 片段 如 下 。 


27 public class TestMedia extends Activity ( 

28 " 

29 (Q override 

30 public void onCreate(Bundle savedInstanceState) ( 
31 - 

32 Button btn1 
33 Button btn2 
34 

35 btnl .setOnClickListener(new ClickEvent()); 

36 btn2 .setOnClickListener(new ClickEvent()); 

37 

38 } 

39 e 

40 — // 实 现 多 个 按钮 的 onClick( ) 方 法 

41 class ClickEvent implements View. OnClickListener ( 


(Button) findViewById(R. id.myButtonl); 
(Button) findViewById(R. id.myButton2); 


42 public void onClick(View v) ( 

43 switch (v.getId()) ( 

44 case R. id. myButtonl: 

45 B //do something 
46 break; 

47 case R. id. myButton2: 

48 ux //do sonething 
49 break; 


50 ) 
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在 一 个 类 中 定义 一 个 内 部 类 也 可 以 代表 解决 问题 的 一 个 操作 。 这 样 做 的 好 处 在 于 如 果 需 
要 实现 多 个 监听 接口 ,这 种 方式 更 清晰 。 

这 些 方式 和 赃 套 接口 类 都 是 一 一 对 应 的 ,在 开发 中 如 果 确 定 其 中 一 种 方式 来 处 理 互动 事 
V ,就 需要 在 Activity 中 实现 相应 的 带 有 这 个 方式 的 接口 ,然后 通过 实例 的 set... Listener O 
方法 来 设置 监听 器 。 例 如 ,调用 setOnClickListener() 来 设置 OnClickListener 作为 监听 器 。 
以 下 三 个 例子 展示 了 如 何 设置 事件 的 监听 。 

【案例 5.2】 对 本 章 的 案例 5. 1 作 改 进 : 将 触 屏 滑动 事件 局 限于 一 个 区 域内 。 

【说 明 】 案例 5. 1 是 在 整个 屏幕 范围 内 捕捉 触 点 的 状态 信息 ,现在 要 求 在 一 个 区 域内 ,就 
必须 设置 一 个 控件 ,在 这 里 将 其 设置 为 一 个 TextView 区 域 ,并 对 该 区 域 的 OnTouchListener 
接口 实现 监听 。 

本 例 使 用 第 一 种 接口 实现 方式 , 即 在 构造 方法 中 使 用 匿名 内 部 类 实现 事件 监听 器 接口 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity TouchArea 的 Android 项 目 。 其 应 用 程 
序 名 为 "TbuchArea”, 包 名 为 cn. com. sgmsc. toucharea, Activity 组 件 名 为 TouchAreaActivity 。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version="1.0" encoding= "utf - 8"?> 

2 «LinearLayout xnlns:android = "http: //schemas. android. con/apk/res/android" 

3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent"» 

6 X TextView 

7 android:id- "(9 + id/touch area" 

8 android:layout width- "fill parent" 


9 android:layout height - "360dip" 

10 android:background = " # FFOOFF" 

ii android: text = "触摸 事件 测试 区 " 

12 android:textColor = " # 99FFFF" 

13 /> 

14 < TextView 

15 android: id = "(9 + id/event label" 

16 android:layout width- "fill parent" 
17 android:layout height = "wrap content" 
18 android:text = "触摸 事件 : " 

19 android:textColor = " # FFFFFF" 

20 /> 


21 «/LinearLayout^ 


本 例 中 的 main. xml 文件 与 案例 5. 1 的 main. xml 没有 太 大 区 别 , 仅 是 将 触 屏 事件 的 测试 
区 背景 色 改 到 了 第 一 个 Text View 控件 中 , 见 第 10 行 中 的 设置 。 

(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. toucharea 包 下 的 TouchAreaActivity. java 
文件 ,并 编辑 之 。 本 例 中 的 代码 设计 思路 与 案例 5. 1 基本 一 致 ,改进 之 处 在 于 将 原来 对 全 屏幕 
触摸 捕捉 ( 即 没有 指定 捕捉 对 象 ) , 改 为 对 一 个 区 域内 的 触 屏 捕捉 ,为 此 设置 了 触摸 区 域 ,并 对 
该 区 域 的 触摸 事件 进行 了 监听 。 代 码 如 下 所 示 。 
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package cn. con. sgnsc. toucharea; 


1 
2 
3 import android. app. Activity; 

4 import android. os. Bundle; 

5 import android. view. MotionEvent; 
6 import android. view. View; 

7 import android. widget. TextView; 
8 
9 


public class TouchAreaActivity extends Activity { 


10 

11 private TextView eventlable; 

12 private TextView TouchView; 

13 

14 @Override 

15 public void onCreate(Bundle savedInstanceState) { 

16 super. onCreate(savedInstanceState); 

17 setContentView(R. layout. main); 

18 TouchView = (TextView) findViewById(R. id. touch area); 
19 eventlable = (TextView) findViewById(R. id. event label); 
20 

21 TouchView. setOnTouchListener(new View.OnTouchListener() { 
22 (2Override 

23 public boolean onTouch(View v, MotionEvent event) { 
24 int action = event.getAction(); 

25 switch (action) ( 

26 // 当 按 下 的 时 候 

27 case (MotionEvent. ACTION DOWN): 

28 Display("ACTION DOWN", event); 

29 break; 

30 // 当 抬 起 的 时 候 

31 case (MotionEvent. ACTION UP): 

32 Display("ACTION UP", event); 

33 break; 

34 // 当 触摸 的 时 候 

35 case (MotionEvent. ACTION MOVE): 

36 Display("ACTION MOVE", event); 

37 ) 

38 return true; 

39 } 

40 H; 

41 } 

42 

43 public void Display(String eventType, MotionEvent event) ( 
44 // 触 点 相对 坐标 的 信息 

45 intx = (int) event.getX(); 

46 int y = (int) event.getY(); 

47 // 表 示 触 屏 压力 大 小 

48 float pressure = event. getPressure(); 

49 // 表 示 触 点 尺寸 

50 float size = event. getSize(); 

51 

52 String msg = ""; 

53 msg += "事件 类 型 : " + eventType + "An"; 

54 msg += "相对 坐标 (x ，yY) : ”+ String.valueOf(x) + "," + String.valueOf(y) + "An"; 


55 msg += " 触 点 压力 : " + String.valueOf(pressure) + "Wn"; 
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56 msg +=" 触 点 尺寸 : "+ String.valueOf(size) + "Wn"; 
57 eventlable. setText (msg); 

58 } 

59 ] 


CD 第 18 行 实例 化 一 个 TextView 类 对 象 ,名 为 “TouchView”, 它 取 自 于 资源 中 ID 为 
“touch_area” 的 控件 对 象 。 

© 第 21 一 41 行为 TouchView 对 象 添加 了 一 个 监听 setOnTouchListener, 同 时 创建 了 监 
听 类 View. OnTouchListener() ,在 这 个 监听 类 中 匿名 地 实现 了 事件 监听 器 接口 。 

© 58 22—39 行 重 写 了 OnTouchListener 接口 的 回调 方法 OnTouchO 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity TouchArea M H. 
运行 结果 如 图 5-2 所 示 。 

【案例 5.3】 将 一 组 单 选 框 中 的 选择 项 进行 清除 。 TouchAre 

【说 明 】 设置 一 个 Button 对 象 , 当 单 击 这 个 按钮 时 ， | 
让 所 有 单 选 按钮 的 选择 状态 均 为 非 选 状态 。 为 此 ,需要 对 
该 Button 进行 OnClickListener() 监 听 。 

本 例 使 用 第 二 种 接口 实现 方式 ,即使 用 外 部 类 实现 事 
件 监听 器 接口 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity 
RadioGroupClear 的 Android 项 目 。 其 应 用 程序 名 为 
“RadioGroupClear”, 包 名 为 cn. com. sgmsc. radiogroupclr. 
Activity 组 件 名 为 RadioGroupActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 布局 文件 ,名 图 5-2 获取 对 有 背景 色 区 域内 的 
为 radio group. xml 文件 ,代码 如 下 所 示 。 触摸 滑动 相关 信息 


1 <?xml version= "1.0" encoding = "utf - 8"? 

2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:layout width- "fill parent" 

4 android:layout height - "fill parent" 

5 android:orientation- "vertical"» 

6 < RadioGroup 

7 android: id= "@ + id/menu" 

8 android:checkedButton = "@ + id/lunch" 


9 android:layout width- "fill parent" 
10 android:layout height = "wrap content" 
11 android:orientation = "vertical" 

12 > 

13 < RadioButton 

14 android: id= "@ + id/breakfast" 
15 android: text = "breakfast" /> 

16 < RadioButton 

17 android: id = "(9 id/lunch" 

18 android:text - "lunch"/» 

19 < RadioButton 

20 android: id= "(9 + id/dinner" 

21 android: text = "dinner" /> 


22 < RadioButton 
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23 android:id- "(9 + id/all" 

24 android:text = "all"/» 

25 «/RadioGroup? 

26 « Button 

27 android:id- "@ + id/clear" 

28 android:layout width- "wrap content" 
29 android:layout height = "wrap content" 
30 android:text = "清除 "/> 


31 </LinearLayout > 


(D 第 6 一 25 行 声 明了 一 个 RadioGroup 控件 ,其 中 定义 了 4 个 RadioButton, 58 8 行 设置 
ID 为 “lunch” 的 按钮 为 选中 状态 。 

@ 第 26—30 行 声明 了 一 个 Button, 

(3) FRÆ, FI src/cn. com. sgmsc. radiogroupclr 包 下 的 RadioGroupActivity. java 
文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. radiogroupclr; 


* 
2 
3 import android. app. Activity; 

4 import android. os. Bundle; 

5 import android. view. View; 

6 import android. widget. Button; 

7 import android. widget. RadioGroup; 
8 
9 
1 


public class RadioGroupActivity extends Activity implements View. OnClickListener { 


0 
11 private RadioGroup mRadioGroup; 
12 
13 (3 Override 
14 protected void onCreate(Bundle savedInstanceState) { 
15 super. onCreate(savedInstanceState); 
16 setContentView(R. layout. radio group); 
17 setTitle("RadioGroup Activity"); 
18 mRadioGroup = (RadioGroup) findViewById(R. id. menu); 
19 Button clearButton - (Button) findViewById(R. id.clear); 
20 clearButton. setOnClickListener(this); 
21 ) 
22 
23 @Override 
24 public void onClick(View v) { 
25 mRadioGroup. clearCheck() ; 
26 } 
27} 


(D 5$ 3—7 行 是 一 些 类 的 引入 。 在 代码 程序 中 用 View, Button, RadioGroup 三 类 对 象 ， 
所 以 在 第 5 一 7 行 要 引入 android. view. View, android. widget. Button 和 android. widget. 
RadioGroup 类 。 

@ 第 9 行 声 明 RadioGroupActivity 类 ,并 实现 View. OnClickListener 事件 监听 器 接口 。 

© 58 13—21 行 重 写 了 onCreate() 方 法 。 其 中 第 18 行 RadioGroup 对 象 mRadioGroup 
获取 实例 ,第 19 行为 Button 对 象 clearButton 获取 实例 。 

CD 第 20 行为 clearButton 对 象 添加 了 一 个 监听 setOnClickListener, 这 里 ,“this” 指 的 是 
本 类 对 象 , 即 RadioGroupActivity 类 。 
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© 第 23 一 26 行 重 写 了 View. OnClickListener 接口 的 回调 方法 OnClick()。 在 此 方法 
中 ,调用 了 RadioGroup 类 的 clearCheck() 方 法 ,其 作用 是 设置 RadioGroup 组 内 的 单 选 按钮 均 
为 非 选中 状态 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity_RadioGroupClear 项 
目 。 运 行 结 果 如 图 5-3 所 示 。 

【案例 5.4】 单 击 按钮 后 ,将 用 户 输入 的 信息 显示 在 屏 【EEC 


幕 的 标题 栏 中 。 br 
【说 明 】 本 例 中 需要 有 用 户 的 输入 操作 ,因此 需要 一 lunch 


个 编辑 框 控件 EditText, 还 需要 一 个 Button 控件 。 当 用 户 dinner 
输入 完成 后 , 单 击 这 个 按钮 ,将 EditText 内 的 信息 传送 到 标 " 
题 栏 中 ,这 个 操作 将 被 定义 在 Button 的 OnClick () 方 法 中 。 m 

本 例 使 用 第 三 种 接口 实现 方式 ,即使 用 内 部 类 实现 事 i 
件 监听 器 接口 。 

【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_Btn 的 Android 项 目 。 其 应 用 程序 
名 为 “ButtonClk”, 包 名 为 cn. com. sgmsc. btn, Activity 组 件 名 为 BtnActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 布局 文件 ,名 为 btn. xml 文件 ,代码 如 下 所 示 。 


图 5-3 清除 单 选 按钮 的 选中 状态 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android: layout_width = "fill parent" 

5 android:layout_height = "fill_parent" 

6 > 

7 

8 « EditText android: id= "(à + id/edit text" 

9 android:layout width- "fill parent" 
10 android:layout height = "wrap content" 
1 android:text = "这 里 可 以 输入 文字 " /> 
12 

13 <Button android: id= "(à + id/get edit view button" 
14 android:layout width = "wrap content" 
15 android:layout height = "wrap content" 
16 android:text = "获取 EditView 的 值 ”/> 


17 </LinearLayout > 


- 般 地 ,如 果 在 代码 中 需要 用 到 的 控件 ,都 需要 向 资源 中 添加 它们 的 ID, 585 8 £3.58 13 
行为 所 声明 的 控件 添加 ID 变量 。 
(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. btn 包 下 的 BtnActivity. java 文件 ,并 编辑 
之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. btn; 


import android. app. Activity; 
import android. os. Bundle; 
import android. view. View; 
import android. widget. Button; 
import android. widget. EditText; 


ou wm 
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8 

9 public class BtnActivity extends Activity ( 

10 /** Called when the activity is first created. * / 
11  (Override 

12 public void onCreate(Bundle savedInstanceState) { 


13 super. onCreate(savedInstanceState); 

14 setTitle("EditText Activity"); 

15 setContentView(R. layout. btn) ; 

16 Button get edit view button = (Button) findViewById(R. id.get edit view button); 
17 get edit view button. setOnClickListener(new get edit view button listener()); 
18 } 

19 

20 private class get edit view button listener implements View. OnClickListener { 

21 public void onClick(View v) { 

22 EditText edit text = (EditText) findViewById(R. id. edit text); 

23 CharSequence edit text value = edit text.getText(); 

24 setTitle(" 输 入 的 值 : " + edit text value); 

25 j 

26 J; 

27} 


(D 第 16 行 ,在 onCreate() 方 法 中 ,获得 按钮 对 象 ,该 按钮 名 为 “get_edit_view_button ”。 
在 实际 编程 中 ,人 们 习惯 使 用 控件 所 执行 的 操作 含义 来 命名 该 控件 对 象 。 这 样 做 便于 程序 的 
维护 。 

© $ 17 ÍTH get_edit_view_button 按钮 添加 一 个 监听 setOnClickListener, 该 监听 的 接 
口 类 是 get_edit_view_button_listener。 

图 第 20~26 行 ,在 BtnActivity 类 的 内 部 ,定义 一 个 
get_edit_view_button_listener 接口 类 。 在 该 接口 类 中 重 写 MA abede 
onClick() 方 法 。 第 23 行使 用 . getText() 方 法 从 EditText 
的 对 象 中 取出 字符 串 信 息 , 并 赋予 字符 串 变量 edit text 
value 中 。 第 24 行使 用 setTitle( ) 方 法 将 一 个 字符 串 信 息 
传送 到 标题 栏 中 ,该 信息 是 “输入 的 值 :" 串 合并 edit text 
value 中 值 串 的 内 容 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 图 5 4 在 单 击 按钮 之 后 获取 编辑 杠 
运行 Activity_Btn 项 目 。 运 行 结果 如 图 5-4 所 示 。 TEN 
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5.2 Android 常用 高 级 控件 


在 第 4 音 中 介绍 了 一 个 Spinner 下 拉 列 表 控 件 , 当 单 击 这 个 控件 时 ,会 有 下 拉 列 表 选 项 。 
那么 这 个 下 拉 列 表 中 的 选项 是 怎样 定义 的 呢 ? 又 怎样 确定 用 户 选 择 了 哪 一 个 选项 呢 ? 在 
Android 系统 中 使 用 了 一 个 适配器 的 机 制 来 处 理 这 些 操 作 。 下 面 来 学 习 与 适配器 相关 的 控件 。 


5.2.1 与 适配器 相关 的 控件 


1. AutoCompleteTextView 


AutoCompleteTextView 类 继承 自 EditText 类 ,位 于 android. widget 包 下 。 从 外 表 上 
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看 ,AutoCompleteTextView 与 EditText 控件 是 一 样 的 ,只 有 在 用 户 进行 输入 中 , 当 输 入 了 与 
事先 为 该 控件 定义 的 一 组 字符 串 集 中 相关 的 信息 时 , 才 会 自动 出 现下 拉 选 项 ,供用 户 选择 。 例 
如 ,事先 为 该 控件 定义 了 一 组 字符 串 集 “我 们 ,我 要 ,我 想 ,我 的 ,我 喜欢 ,我 非常 ”, 当 用 户 在 编 
辑 框 内 输入 了 一 个 “我 " 字 ,就 会 在 控件 下 方 自动 出 现下 拉 选 项 ,将 这 一 系列 的 “我 …” 显 示 出 来 
供用 户 选择 。 这 有 点 像 在 中 文 输入 法 中 设置 了 联想 输入 方式 。 

AutoCompleteTextView 的 某 些 属性 可 以 在 XML 文件 中 进行 设置 ,也 可 以 在 Java 代码 
中 通过 方法 进行 设置 。 下 面 是 AutoCompleteTextView 控件 常用 的 属性 和 相应 的 方法 ,如 
表 5-2 BER. 


表 5-2 AutoCompleteTextView 常用 的 属性 和 相应 方法 说 明 


RB 性 5 法 描 g 
android:completionThreshold setThreshold (int) 设置 用 户 输入 的 字符 数 , 当 用 户 输 
人 够 该 设 定 的 字符 数 后 开始 显示 下 
拉 列 表 
android:dropDownHeight setDropDownHeight (int) 设置 下 拉 列表 的 高 度 
android: dropDownWidth setDropDownWidth (int) 设置 下 拉 列 表 的 宽度 


android: popupBackground setDropDownBackgroundResource(int) 设置 下 拉 列 表 的 背景 


从 表 5-2 可 以 看 出 ,这 些 属 性 主要 用 于 设置 AutoCompleteTextView 控件 下 拉 时 的 外 形 。 
在 下 拉 列 表 中 的 选项 内 容 ,需要 绑 定 到 数据 源 上 , 绑 定数 据 需 要 用 到 适配器 (Adapter) 。 

适配器 是 界面 数据 绑 定 的 一 种 理解 。 它 所 操纵 的 数据 包括 数组 .链表 、 数 据 库 、 集 合 等 。 
适配器 就 像 显示 器 ,把 复杂 的 东西 按 人 可 以 接受 的 方式 来 展现 。 

在 Android 中 有 很 多 的 适配器 ,常用 的 适配器 有 ArrayAdapter、SimpleAdapter、 
SimpleCursorAdapter, 它 们 都 是 继承 自 BaseAdapter, 这 些 Adapter 都 位 于 android. widget 包 下 。 
其 中 以 Array Adapter 最 为 简单 ,顾名思义 ,需要 把 数据 放 入 一 个 数组 中 以 便 显示 ,一 般 是 展示 一 
行 字符 。SimpleAdapter 有 最 好 的 扩充 性 ,可 以 自 定义 出 各 种 效果 。SimpleCursorAdapter 可 以 
认为 是 SimpleAdapter 对 数据 库 的 简单 结合 ,可 以 方便 地 把 数据 库 的 内 容 以 列表 的 形式 展示 
出 来 。 

Adapter 对 象 有 两 个 主要 责任 : 一 是 用 数据 填充 布局 ,二 是 处 理 用 户 的 选择 。 下 面 以 
AutoCompleteTextView 控件 定义 为 例 ,说 明 ArrayAdapter 的 使 用 。 

【案例 5.5】 AutoCompleteTextView 的 使 用 方法 。 

【说 明 】 AutoCompleteTextView 的 下 拉 列 表 中 只 是 一 些 字符 串 , 可 以 使 用 String[ ] 数 
据 源 来 创建 一 个 ArrayAdapter ,为 下 拉 列 表 进 行 数据 绑 定 。 

创建 一 个 适配器 实例 , 即 是 为 适配器 指定 显示 格式 及 数据 源 。 实 例 化 ArrayAdapter 可 使 
用 下 列 方法 ,其 格式 为 : 


public ArrayAdapter (Context context, int textViewResourceld, T[] objects) 


参数 context, 为 当期 的 上 下 文 对 象 。 通 常 使 用 this。 

参数 textViewResourceId ,一 个 包含 TextView 的 布局 XML 文件 的 id, 用 于 告诉 系统 以 
什么 样 的 布局 方式 来 填充 数据 。 例 如 ,参数 值 为 "android. R. layout. simple dropdown item | 
lline”, 这 是 系统 定义 好 的 布局 文件 ,表示 在 下 拉 列 表 中 一 个 数据 只 显示 一 行文 字 串 。 

参数 objects ,是 给 Array Adapter 提供 数据 的 数组 ,用 来 填充 下 拉 列 表 。 
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【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_AutoCompleteTxt 的 Android 项 目 。 
其 应 用 程序 名 为 “AutoCompleteTxt”, 包 名 为 cn. com. sgmsc. autocompletetext, Activity 组 件 
名 为 AutoCompleteTextViewActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 布局 文件 ,名 为 autocomplete. xml 文件 ,代码 如 
下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android = "http: //schemas. android. con/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "wrap content"» 

6 

T < hutoCompleteTextView android:id - "(2 + id/auto complete" 
8 android:layout width- "fill parent" 

9 android:layout height = "wrap content" /> 

10 


11 «/LinearLayout > 


在 布局 文件 中 只 声明 了 一 个 AutoCompleteTextView 控件 ,其 资源 id Jy "auto _ 
complete" , 
(GD JF X iE H (C 83. 1T JF src/cn. com. sgmsc. autocompletetext 包 下 的 
AutoCompleteText View Activity. java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 
1 package cn. com. sgnsc. autocompletetext; 
2 
3 import android. app. Activity; 
4 import android. os. Bundle; 
5 import android. widget. ArrayAdapter; 
6 import android. widget. AutoCompleteTextView; 
7 
8 
9 


public class AutoCompleteTextViewActivity extends Activity ( 


@Override 
10 protected void onCreate(Bundle savedInstanceState) { 
3 super. onCreate(savedInstanceState); 
12 setContentView(R. layout. autocomplete); 
13 setTitle("AutoCompleteTextView Activity"); 
14 ArrayAdapter «String? adapter = new ArrayAdapter < String>( 
15 this, 
16 android.R.layout.simple dropdown item 1lline, 
17 OUNTRIES) ; 
18 AutoCompleteTextView autotextView = (AutoCompleteTextView) findViewById(R. id.auto 
conplete); 
19 autotextView. setAdapter(adapter); 
20 autotextView. setThreshold(1); 
21 } 
22 static final String[] COUNTRIES = new String[] { 
23 "China" ,"Russia", "Germany", "Ukraine", "Belarus", 
24 "USA" ,"Chinal" ,"Chinal2", "Germanyl", 
25 "Russia2", "Belarusl", "USA1" 
26 N 


21] 
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(D 第 3 一 6 行 是 一 些 类 的 引入 。 在 代码 程序 中 用 ArrayAdapter 和 AutoCompleteTextView 
类 对 象 , 所 以 在 第 5.6 行 要 引入 android. widget. ArrayAdapter 和 android. widget. 
AutoCompleteTextView 类 。 

© 第 14—17 行 创建 一 个 适配器 并 将 其 实例 化 。 其 中 第 16 行使 用 的 是 Android 系统 自 
带 的 简单 布局 ,第 17 行将 资源 数组 OUNTRIES 传人 。 

C 第 18 行 获取 这 个 控件 引用 autotextView。 

@ 第 19 行使 用 setAdapter(adapter) 设 置 适配器 。 

© 第 20 行 定义 用 户 需 要 输入 的 字符 数 为 1, 即 当 用 户 输入 一 个 字符 时 就 下 拉 相 应 的 选项 
列表 。 

© 第 22 一 26 行 定义 一 个 名 为 OUNTRIES 的 常量 数组 ,作为 适配器 的 资源 数组 。 
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2. Spinner 


Spinner CF f 9 AK) f F android. widget 44 F. Spinner 
的 外 观 是 一 个 一 行 的 列表 框 , 右 侧 有 一 个 下 拉 按 钮 ,只 有 当 用 
户 单 击 这 个 控件 时 , 才 会 下 拉 出 选项 列表 供用 户 选择 。 

在 应 用 中 常常 会 遇 到 这 样 的 情况 ,应 用 系统 已 为 用 户 提 
供 了 一 些 选择 项 , 而 不 需要 用 户 填写 内 容 。 这 时 需要 使 用 
Spinner 控件 。Spinner 每 次 只 显示 用 户 选中 的 元 素 , 当 用 户 
再 次 单 击 时 ,会 弹出 选择 列表 供用 户 选择 ,而 选择 列表 中 的 元 
素来 自 一 个 适配器 ,这 个 选项 资源 适配器 通常 在 代码 中 写 入 。 

如 果 使 用 ArrayAdapter 为 Spinner 的 下 拉 列 表 加 载 数 
据 , 有 以 下 两 种 方式 。 图 5-5 AutoCompleteTextView 

C). 使 用 Java 代码 动态 地 定义 下 拉 列 表 的 数据 源 。 例 如 pps nudis 
向 Spinner 的 下 拉 列 表 加 载 城市 名 ,可 使 用 方法 : 


ArrayAdapter < String > adapter = New ArrayAdapter (this, android.R.layout.simple spinner item, 

citys) 

其 中 ,参数 “android. R. layout. simple_spinner_item” 是 系统 定义 好 的 布局 文件 ,表示 在 
Spinner 未 被 单 击 时 的 显示 样式 ; 参数 citys 是 在 代码 中 定义 的 数组 ,该 数组 是 预 置 的 一 些 城 
市 名 。 

(2) 在 res/values 目录 下 ,使 用 XML 文件 预先 定义 数据 源 。 例 如 向 Spinner 的 下 拉 列 表 
中 加 载 城市 名 ,可 使 用 方法 : 


ArrayAdapter < CharSequence > adapter = ArrayAdapter.createFromResource(this, R. array. citys, 
android.R.layout.simple spinner item); 
其 中 ,参数 R. array. citys 对 应 于 res/values 目录 下 XML 格式 的 数组 资源 描述 文件 ,在 其 
中 预先 定义 一 组 城市 名 ,为 Spinner 的 下 拉 列 表 提 供 数据 ; 参数 “android. R. layout. simple_ 
spinner_item” 设 置 在 Spinner 未 被 单 击 时 的 显示 样式 。 
在 Java 代码 编程 中 ,Spinner 控件 有 一 些 常 用 的 方法 ,如 表 5-3 所 示 。 
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表 5-3 Spinner 常用 的 方法 说 明 


5 法 描 述 
getItemAtPosition(int) 获取 在 下 拉 列 表 中 指定 位 置 的 数据 
getSelectedItem() 获取 用 户 在 下 拉 列 表 中 选 定 的 数据 
setDropDownViewResource(int) 设置 下 拉 列 表 的 显示 样式 ,其 中 的 int 参数 是 指定 布局 资源 的 ID 号 
setPrompt(String) 设置 下 拉 列 表 框 的 提示 信息 
setSelection(int, boolean) 设置 Spinner 在 初始 化 时 自动 调用 一 次 OnItemSelectedListener 事件 


指定 的 下 拉 项 ,如 果 禁 止 调用 该 事件 ,可 使 用 setSelection(0,true) 


通常 ,实现 一 个 Spinner 需要 完成 以 下 五 个 步骤 。 

(1) 第 一 步 , 为 下 拉 列 表 项 定义 数据 源 。 

(2) 第 二 步 , 实 例 化 一 个 适配器 。 

(3) 第 三 步 ,为 Spinner 设置 下 拉 列 表 下 拉 时 的 显示 样式 。 

(4) 第 四 步 , 将 适配器 添加 到 Spinner 上 。 

(5) 第 五 步 ,为 Spinner 添加 监听 器 ,设置 各 种 事件 的 响应 操作 。 

【案例 5.6】 试 设计 Spinner, 用 于 选择 所 在 城市 名 。 

[88] 在 这 个 Spinner 中 ,下 拉 列 表 选 项 只 是 一 些 城市 名 ,可 以 使 用 String[ ] 数 据 源 来 
创建 一 个 ArrayAdapter, 为 下 拉 列 表 进 行 数据 绑 定 。 

前 面 已 经 介绍 ,为 Spinner 创建 ArrayAdapter 实例 有 两 种 方式 ,因为 使 用 第 一 种 方式 创 
建 与 案例 5. 5 的 代码 编程 差不多 ,所 以 本 例 以 使 用 第 二 种 方式 为 主 来 创建 ArrayAdapter 实例 
(而 以 注释 方式 给 出 第 一 种 方式 的 编程 代码 ) 。 

【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity Spinner 的 Android 项 目 。 其 应 用 程 
序 名 为 “Spinner”, 包 名 为 cn. com. sgmsc. spinner. Activity 组 件 名 为 SpinnerActivity。 

(2) 创建 数组 资源 文件 。 在 res/values 目录 下 创建 一 个 名 为 arrays. xml 的 文件 (如 果 使 
用 第 一 种 方式 为 Spinner 的 下 拉 列 表 加 载 数据 ,就 不 需要 创建 这 个 文件 ) arrays. xml 文件 的 
代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf — 8"?> 
2 «resources?» 


3 < string- array name = "citys"> 
4 < item > 北京 </item> 

5 <item> Fific/iten» 

6 <item> 广 州 </item> 

7 < iten > 深圳 </item> 

8 < item > 杭州 </item> 

9 < iten > 成 都 </item> 

10 < item> 大 连 </item> 

n < iten > 南京 </item> 

12 «/string- array» 


13 «/resources » 


第 3 行 定 义 了 这 个 资源 数组 的 名 称 为 “citys”。 注 意 ,在 代码 中 调用 此 数组 资源 时 ,与 
XML 文件 名 无 关 ,而 只 与 “一 string-array name= "citys" >” E XL] A Fk" citys "t X, 
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(3) 设计 布局 。 编 写 res/layout 目录 下 的 布局 文件 ,名 为 spinner. xml 文件 ,代码 如 下 


所 示 。 


20 
21 


<?xml version= "1.0" encoding = "utf - 8"?> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:id- "(2 + id/widget28" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:orientation = "vertical" 


> 


< TextView 


android: 
android: 
android: 
android: 


android: 


< Spinner 


android: 
android: 
android: 


</LinearLayout > 


id= "(à + id/TextView_Show" 
layout width- "fill parent" 
layout height = "wrap content" 
text = "可 以 开始 选择 所 在 城市 了 。" 
textSize = "25sp"/> 


id- "(9 + id/spinner City" 
layout width- "fill parent" 
layout height = "wrap content"/» 


(D 第 9 一 14 行 声明 了 一 个 TextView 控件 ,用 于 显示 从 Spinner 的 下 拉 列 表 中 选择 的 


内 容 


Q 第 16 一 19 行 声明 了 一 个 Spinner 控件 。 


OD 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. spinner 包 下 的 SpinnerActivity. java 文件 ， 
并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. spinner; 


import android. 


app. Activity; 


import android. os. Bundle; 

import android. view. View; 

import android. widget. AdapterView; 
import android. widget. ArrayAdapter; 
import android. widget.Spinner; 
import android. widget. TextView; 


11 public class SpinnerActivity extends Activity { 


12 
13 
14 


15 
16 
37 
18 
19 
20 


// 方 式 一 ”声明 citys 字符 串 数组 ,为 Spinner 的 下 拉 列 表 预 定义 数据 : 
// 方 式 一 。 private static final String[] citys = {" 北 京 ", "上 海 ", "广州 ", "深圳 ", "杭州 ", "成 
都 ", "大连", "南京 "}; 

private TextView text; 

private Spinner spinner; 


(GOverride 


public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
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21 
22 
23 
24 
25 
26 // 方 式 一 
27 // 方 式 一 
28 // 方 式 一 
29 // 方 式 一 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 


45 
46 
47 
48 


49 // 方 式 一 
50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 } 
61} 
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setContentView(R. layout. spinner); 
text = (TextView)findViewById(R. id. TextView Show); 
spinner - (Spinner)findViewById(R. id. spinner City); 


// 实 例 化 ArrayAdapter: 
Arrayhdapter« String» adapter = new ArrayAdapter < String»( 

this, 
android.R.layout.simple spinner item, 
citys); 

ArrayAdapter < CharSequence > adapter = ArrayAdapter. createFromResource( 
this, 
R.array.citys, 
android.R.layout.simple spinner item); 


// 设 置 Spinner 的 下 拉 列表 显示 样式 
adapter. setDropDownViewResource(android.R.layout. simple spinner dropdown item); 


// 将 adapter 添加 到 Spinner 中 
spinner. setAdapter(adapter); 


// 设 置 Spinner 的 一 些 属 性 
spinner. setPrompt(" 请 选择 城市 : "); 


spinner.setSelection(0, true); 


// 添 加 Spinner 事件 监听 
spinner. setOnItenSelectedListener(new Spinner. OnItenSelectedListener()( 
(QOverride 
public void onItemSelected (AdapterView «?» arg0, View argl, int arg2, long 
arg3) { 
text. setText(" 你 所 在 的 城市 是 : " + citysarr[arg2]); 
text. setText ("你 所 在 的 城市 是 : " + arg0. getItemAtPosition (arg2). toString()); 
// 设 置 显示 当前 选择 的 项 
arg0. setVisibility(View. VISIBLE) ; 
) 


@Override 
public void onNothingSelected(AdapterView «?» arg0) { 
) 

ni 


行 是 一 些 类 的 引入 。 在 代码 程序 中 使 用 了 View, AdapterView, ArrayAdapter, 


Spinner 和 TextView 类 对 象 , 所 以 在 第 5 一 9 行 引 入 了 android. widget. View、android. widget. 
AdapterView android. widget. ArrayAdapter android. widget. Spinner 和 android. widget. 


TextView 25, 


@ 第 14 行 是 使 用 方式 一 为 Spinner 的 下 拉 列 表 加 载 数据 ,声明 一 String 类 型 的 数组 
citys ,并 为 该 数组 赋 初 值 。 另 外 ,我 们 还 可 以 使 用 getStringArray() 方 法 从 XML 数组 描述 文 
件 中 载 人 数组 的 值 , 例 如 从 arrays. xml 文件 中 载 入 数组 值 方法 如 下 : 
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String citys[] = getResources().getStringArray(R. array.citys); 


@ 第 18—60 行 是 重 写 了 onCreate() 方 法 。 

印 第 26 一 29 行 是 使 用 方式 一 创建 一 个 名 为 adapter 的 ArrayAdapter 实例 。 这 个 
Array Adapter 的 数据 来 自 数组 citys. 

© $ 30 — 33 行使 用 方式 二 创建 一 个 名 为 adapter 的 ArrayAdapter 实例 。 这 个 
ArrayAdapter 的 数据 来 自 arrays. xml 数组 描述 文件 中 ,注意 ,使 用 该 方式 , ArrayAdapter 的 
类 型 必须 指定 为 CharSequence, 不 能 是 String, 否 则 会 出 错 

© 第 36 行 设置 adapter 将 要 绑 定 的 Spinner 对 象 的 下 拉 列 表 显示 样式 。 

CD 第 39 行为 指定 的 Spinner 添加 适配器 adapte, 

@ 第 42 一 43 行为 Spinnerr 设置 部 分 属性 ,这 些 属性 的 设置 有 助 于 UI 的 友好 性 。 其 
中 ,第 42 行 是 设置 该 Spinner 的 下 拉 列 表 的 提示 信息 , 它 可 以 起 到 下 拉 列 表 的 标题 作用 ; 第 
43 行 是 保证 当 项 目 初始 运行 时 ,不 让 Spinner 调用 OnItemSelectedListener 事件 ,因此 在 
TextView 处 不 会 有 Spinner 的 选中 项 出 现 ,如 图 5-6 所 示 。 这 两 条 语句 不 是 必需 的 ,可 以 
省 略 。 

(9) 第 46 一 58 行为 Spinner 对 象 添加 一 个 OnItemSelectedListener 监听 ,在 其 中 重 定义 一 
些 回调 方法 ,这 里 重 写 的 方法 包括 onItemSelectedO 。 

问 一 下 : 

onltemSelected() 方 法 中 的 参数 各 是 什么 含义 ? 

onltemSelected() 方 法 的 格式 为 : 


public void onItemSelected(AdapterView <?> arg0, View argl, int arg2, long arg3) 


参数 arg0 指 的 是 适配器 视图 对 象 ,在 这 里 可 以 理解 为 Spinner 的 下 拉 列 表 视 图 。 其 中 ， 
AdapterView 是 内 容 由 适配器 来 决定 的 视图 类 ,<?> 是 适配器 里 内 容 的 类 型 ,可 以 把 “?” 理 解 
成 你 的 适配器 中 的 选项 数据 的 类 型 。 

参数 argl 指 的 是 适配器 视图 里 的 被 单 击 的 对 象 。 可 以 理解 成 下 拉 列 表 框 中 被 选中 的 那 
一 项 。 

参数 arg2 指 在 下 拉 列 表 选 项 中 被 选择 项 的 位 置 。 这 个 参数 类 型 是 int 型 ,从 0 开始 。 

参数 arg3 指 被 单 击 选项 所 在 行 的 行 ID 号 。 这 个 参数 类 型 是 long 型 。 

D 第 49 行使 用 方式 一 ,取得 用 户 选中 的 Spinner. 下 拉 选 项 值 ,并 将 其 赋予 TextView 的 
对 象 text 中 。 

D 第 50 行使 用 方式 二 ,取得 用 户 选中 的 Spinner 下 拉 选 
项 值 ,并 将 其 赋予 TextView 的 对 象 text 中 。toString() 是 将 
获取 的 值 强制 为 String 型 。 

(2 第 52 行 , 显 示 用 户 当 前 选择 项 的 信息 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 Activity Spinner 项 目 。 初 始 运 行 结果 如 图 5-6 所 示 , 单 击 
T Spinner 控件 后 下 拉 出 选项 列表 ,如 图 5-7 所 示 , 当 在 下 拉 
列表 中 选择 了 “广州 ”之 后 ,显示 结果 如 图 5-8 所 示 。 图 5-6 初始 运行 时 的 显示 界面 
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请 选择 城市 : 


图 5-7 Mit Spinner 后 下 拉 的 列表 选项 图 5-8 选择 了 城市 “广州 之 后 的 显示 界面 


3. ListView 


ListView 类 位 于 android. widget 包 下 ,是 Android 应 用 开发 过 程 中 最 常用 的 控件 之 一 。 
它 是 以 垂直 的 可 滚动 的 列表 方式 显示 一 组 列表 项 的 视图 ,ListView 里 面 的 每 个 条 目 Item 可 
以 是 一 个 TextView ,也 可 以 是 由 多 个 TextView 和 ImageView 组 成 的 一 个 组 合 控件 。 例 如 ， 
显示 联系 人 名 单 .系统 设置 项 等 ,都 会 用 到 ListView. 

实现 一 个 ListView 控件 ,主要 分 为 以 下 4 个 步骤 。 

(1) 第 一 步 ,准备 ListView 要 显示 的 数据 ,使 用 一 维 或 多 维 动态 数组 保存 数据 。 

(2) 第 二 步 , 构 建 适配器 。 由 于 ListView 的 每 一 个 Item 的 组 成 可 能 简单 ,也 可 能 比较 复 
杂 , 所 以 根据 需要 ,可 选择 ArrayAdapter, SimpleAdapter 或 BaseAdapter 来 为 ListView 绑 定 

(3) 第 三 步 , 使 用 setAdapter() ,把 适配器 添加 到 ListView ,并 显示 出 来 。 

(4) 第 四 步 ,为 ListView 添加 监听 器 ,设置 各 种 事件 (如 单 击 滚动. 单 击 长 按 等 ) 的 响应 


ListView 常用 的 监听 包括 : Q@ 单 击 监听 ,添加 单 击 监 听 使 用 List View. setOnItemClickListenerO ; 
滚动 监听 ,添加 深 动 监听 使 用 ListView. setOnItemSelectedListenerO ; @ 长 按 监听 ,添加 长 
按 监听 使 用 setOnCreateContextMenuListenerO 。 

1) 使 用 ArrayAdapter 适配器 

在 设计 中 ,使 用 ArrayAdapter 适配器 为 ListView 绑 定 数据 ,可 以 创建 每 条 目 显 示 一 行 字 
符 串 的 ListView 控件 。 其 具体 的 实现 方法 与 案例 5.5 和 5. 6 中 创建 适配器 的 方法 差 不 
多 ,如 : 


ArrayAdapter < String > adapter = new ArrayAdapter < String >(this, android. R. layout. simple_list_ 
item 1, strings); 


其 中 ,“android. R. layout. simple_list_item_1” 是 系统 定义 好 的 布局 文件 ,表示 以 一 行 的 
文本 显示 ListView 的 一 个 Item 项 的 样式 ;“strings” 是 在 代码 中 定义 的 数组 ,也 可 以 是 一 个 列 
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表 数 据 集合 List, 它 们 为 适配器 提供 数据 源 ,用 于 ListView 的 显示 。 
2) 使 用 simpleAdapter 适配器 
simpleAdapter 的 扩展 性 最 好 ,可 以 定义 各 种 各 样 的 布局 ,例如 可 以 放 上 ImageView( 图 
片 ), 还 可 以 放 上 Button( 按 钮 ),CheckBox( 复 选 框 ) 等 。 使 用 simpleAdapter 构造 数据 一 般 都 
是 用 数组 列表 ArrayList, 它 定义 于 java. util. ArrayList 类 中 ,而 ArrayList 一 般 是 通过 
HashMap 构成 ,HashMap 是 一 组 键 - 值 对 的 集合 ,HashMap 定义 于 java. util. HashMap 类 中 。 
例如 ,要 生成 一 个 ArrayList 类 型 的 变量 list, 并 向 其 中 填充 两 组 HashMap 键 - 值 对 
mapl、map2 ,使 用 代码 段 如 下 。 
ArrayList < HashMap < String, String>> list = new ArrayList < HashMap< String,String>>(); 
// 生 成 两 个 HashMap 类 型 的 变量 map1, map2 
HashMap < String, String» mapl = new HashMap< String, String»(); 
HashMap< String，String> map2 = new HashMap< String, String>(); 
// 把 数据 填充 到 mapl 和 map2 中 
mapl.put("title", "百度 "); 
mapl.put("title ip", " http://www. baidu. com/"); 
nap2. put("title"，" 新 浪 "); 
map2.put("title ip", " http://www. sina. com. cn/"); 
10 // 把 mapl 和 nap2 添加 到 list 中 
11 list.add(mapl); 
12 list.add(map2); 
第 6 行为 mapl 的 键 名 为 title” 的 传 值 “百度 ”。 第 7 行为 mapl 的 又 一 键 名 为 “title_ip” 
的 传 值 *http://www. baidu. com/”。 这 个 HashMap 有 两 个 键 - 值 对 。 
利用 SimpleAdapter 创建 适配器 实例 ,其 构造 方法 有 5 个 参数 ,有 些 参数 还 比较 复杂 。 例 
如 ,在 本 类 中 创建 一 个 名 为 adapter 的 SimpleAdapter 对 象 ,使 用 语句 如 下 。 
SimpleAdapter adapter = new SimpleAdapter( 
this, 
alist, 
R. layout. item, 
new String[]("ing", "title", "info"], 
new int[](R. id. ing, R. id. title, R. id. info} ); 
参数 this 指 当 前 Activity 的 对 象 。 
参数 alist 是 一 个 ArrayList 类 型 的 列表 对 象 , 它 向 adapter 中 填充 数据 。 
参数 R. layout. item 是 一 个 XML 布局 文件 的 ID,ID 所 指 的 布局 文件 用 于 设置 ListView 
中 Item 的 布局 。 
参数 new String[]{f"img","title","info"} 是 一 个 String 类 型 的 数组 ,该 数组 中 的 元 素 确 
定 了 alist 对 象 中 的 列 ,alist 中 有 几 列 对 应 这 个 数组 中 就 要 有 几 个 元 素 。 
参数 new int[]{R. id. img,R.id.title,R.id.info} 是 一 个 int 类 型 的 数组 ,该 数组 中 的 元 素 
对 应 着 R. layout. item 所 指 的 布局 文件 中 的 控件 资源 ID, 并 且 其 顺序 和 个 数 与 上 一 个 参数 
String 类 型 数组 中 的 列 名 一 一 对 应 。 例 如 ,String 类 型 数组 的 第 一 个 元 素 是 “img”, 那 么 int 类 
型 数组 的 第 一 个 元 素 就 是 R. id. img, 它 是 R. layout. item 布局 文件 中 声明 的 名 为 “img” 的 控 
件 ID,String 类 型 数组 的 第 一 个 元 素 是 “title”, 那 么 int 类 型 数组 的 第 一 个 元 素 就 是 R. id. 
title, 它 是 R. layout. item 布局 文件 中 声明 的 名 为 “title” 的 控件 ID,……, 如 此 对 应 下 去 。 
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下 面 使 用 一 个 案例 来 说 明 , 如 何 使 用 simpleAdapter 适配器 为 ListView 控件 绑 定 数据 。 
【案例 5.7】 使 用 SimpleAdapter 适配器 为 ListView 绑 定数 据 , 列 出 国内 一 些 著名 网 站 
名 及 网 址 信息 , 单 击 某 一 条 目 时 ,在 标题 栏 显 示 其 网 址 信息 ,如 图 5-9 和 图 5-10 所 示 。 


图 5-9 初始 运行 时 显示 的 ListView 界面 图 5-10 单 击 ListView 第 三 项 后 的 界面 


【说 明 】 使 用 simpleAdapter 构造 数据 需要 用 到 ArrayList, 其 中 的 HashMap 对 象 对 应 
于 ListView 中 的 每 一 条 目 (Item) 。 在 本 例 中 ,ListView 中 的 每 一 Item 包括 一 个 ImageView 
控件 和 两 个 分 上 下 行 的 TextView 控件 。 这 个 布局 可 以 使 用 一 个 在 res/layout 目录 中 的 
XML 布局 文件 来 定义 。 

在 本 案例 中 要 求 每 单 击 ListView 的 一 个 Item 项 ,就 要 在 标题 栏 显 示 相 关 信 息 , 所 以 需要 
为 该 ListView 对 象 添 加 OnItemClickListener() 监 听 , 重 写 


Da Slr” 0 
onltemClick() 回 调 方 法 。 在 onItemClick( 〇 方法 内 执行 获 B cb Lianti A 
取 Item 的 信息 ,并 将 其 显示 在 标题 栏 中 操作 。 Bener 
【开发 步骤 及 解析 】 Bh comandroidide ecipse adt LIBRARIES. 
CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity - x 
dravable-hdpi 
List ViewSimpleAdt 的 Android 项 目 。 其 应 用 程序 名 为 mre 


ListViewSimpleAdt, 包 名 为 cn. com. sgmsc. listviewsimpleadt, 
Activity 组 件 名 为 ListViewSimpleAdtActivity。 

(2) 准备 图 片 资源 。 将 图 片 资源 复制 到 本 项 目的 res 
drawable-mdpi 目录 中 ,如 图 5-11 所 示 。 

(3) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml W 5-11 Activity ListViewSimpleAdt 
文件 为 listv_sa. xml, 并 编辑 之 。 代 码 如 下 所 示 。 中 的 图 片 资源 目录 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 «LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
3 android:id- "@ + id/LinearLayout01" 

android:layout width- "fill parent" 

android:layout height = "fill parent" 

> 


wous 


第 5 章 ”Android 高 级 控件 及 事件 处 理应 用 


8 <ListView 

android:id- "(9 + id/ListView01" 
10 android:layout width- "fill parent" 
11 android:layout_height = "wrap_content" 
12 /> 
13 


14 «/LinearLayout > 

第 8 一 12 行 声明 了 一 个 ListView 控件 ,其 ID 名 为 ListView01。 

(4) 设计 ListView 的 条 目 布局 。 在 res/layout 目录 下 创建 一 个 名 为 listitem. xml 的 布局 
文件 ,该 文件 为 ListView 的 每 一 个 Item 对 象 布局 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 <LinearLayout xmlns:android= "http://schemas.android. com/apk/res/android" 
3 android:orientation = "horizontal" 

4 :layout width- "fill parent" 

5 android:layout height = "fill parent"» 

6 

7 < ImageView android: id = "@ + id/img" 

8 android:layout width = "49dip" 

9 android:layout height = "50dip" 

10 android:layout margin = "5px"/» 

11 

12 < LinearLayout android:orientation = "vertical" 
13 android: layout_width = "wrap content" 

14 android:layout height = "wrap_content"> 

15 < TextView android: id= "@ + id/title" 

16 android:layout width- "wrap content" 
17 android: layout_height = "wrap_content" 
18 android: textColor = " # FFFFFFFF" 

19 android: textSize = "22px" /> 

20 

21 « TextView android: id= "@ + id/info" 

22 android:layout width- "wrap content" 
23 android:layout height = "wrap content" 
24 android:textColor = " # FFFFFFFE" 

25 android: textSize = "13px" /> 

26 </LinearLayout > 


27 </LinearLayout > 


(D 第 7 一 10 行 声明 了 一 个 ImageView 控件 ,其 ID 名 为 img。 为 了 在 ListView 中 每 一 
Item 的 高 度 一 致 ,并 且 显 示 的 图 片 大 小 也 相应 一 致 ,在 此 给 出 ImageView 的 具体 宽度 、 高 
度 值 。 

© 第 12—26 行 声明 一 个 内 艇 的 LinearLayout, 用 于 定义 两 行文 本 控件 ,所 以 需要 设置 属 
性 android :orientation= "vertical" 。 

@ 58 15—19 行 声明 了 一 个 TextView 控件 ,其 ID 名 为 title, 并 设置 了 文本 的 大 小 和 文字 
颜色 。 

(D 58 21—25 行 声明 又 一 个 TextView 控件 ,其 ID 名 为 info, 并 设置 了 文本 的 大 小 和 文字 
颜色 。 
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(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. listviewsimpleadt 包 下 的 ListViewSimpleAdtActivity. 
java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. con. sgnsc. listviewsimpleadt; 


import java. util. ArrayList; 
import java. util. HashMap; 
import java. util. List; 
import java. util. Map; 


import android. app. Activity; 

import android. os. Bundle; 

import android. widget. ListView; 

import android. widget.SimpleAdapter; 

import android. view. View; 

import android. widget. AdapterView; 

import android. widget. AdapterView. OnItemClickListener; 


public class ListViewSimpleAdtActivity extends Activity ( 


//private List «String» data = new ArrayList < String>(); 
@Override 
public void onCreate(Bundle savedInstanceState) { 


} 


super. onCreate(savedInstanceState); 

setContentView(R. layout.listv sa); 

// 获 得 Layout 里 面 的 ListView 

ListView list = (ListView) findViewById(R. id. ListView01); 


// 生 成 适配器 的 Item 和 动态 数组 对 应 的 元 素 
SimpleAdapter listItemAdapter = new SimpleAdapter( 
this, 
getData(), 
R. layout. listitem, 
new String[]("ing","title","info"], 
new int[ ] {R. id. img, R. id. title, R. id. info} ); 


// 添 加 并 且 显示 
list. setAdapter(listlItemAdapter); 


// 添 加 单 击 监听 
list.setOnItemClickListener(new OnItemClickListener() { 
GOverride 
public void onItemClick(AdapterView«?» arg0, View argl, int arg2, long arg3) { 
Map< String, Object» clkmap = (Map< String, Object») arg0. 
getItemAtPosition(arg2); 
setTitle(clkmap.get("title").toString() +" 的 网 址 为 : " + clkmap. 
get(" info").toString()); 


n; 


// 生 成 多 维 动态 数组 ,并 加 入 数据 
private List <Map< String, Object >> getData() { 


ArrayList < Map< String, Object?» listitem = new RrrayList<Map< String, Object?»(); 
Map< String, Object» map = new HashMap« String, Object»(); 


map. put("img", R.drawable.tb baidu); 
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53 map.put("title", "EH HE"); 

54 map. put("info", "http://www. baidu. com/") ; 
55 listitem. add(map); 

56 

57 map = new HashMap « String, Object»(); 
58 map.put("img", R.drawable.tb sina); 

59 map. put("title", "Erii"); 

60 map. put(" info", "http://www. sina. com. cn/") ; 
61 listitem. add(map) ; 

62 

63 map = new HashMap « String, Object»(); 
64 map. put("img", R.drawable.tb tencent); 
65 map. put("title", "腾讯"); 

66 map. put("info", "http://www. qq. com/") ; 
67 listitem. add(map) ; 

68 

69 map = new HashMap« String, Object»(); 
70 map. put("img", R.drawable.tb netease); 
"n nap. put(" title", "网 易 "); 

72 map. put(" info", "http://www. 163. con/") ; 
73 listitem. add(map) ; 

74 

75 return listitem; 

76 H 

77 

78 ] 


(D 第 3—6 行 是 一 些 Java 类 的 引入 。 在 代码 中 使 用 了 ArrayList, HashMap, List 和 Map 
对 象 , 这 些 对 象 都 定义 于 java. util 下 的 相应 包 内 ,所 以 需要 引入 java. util. ArrayList, java. 
util. HashMap, java. util. List 和 java. util. Map, 

@ 第 8 一 14 行 引入 代码 中 用 到 的 Android 中 的 相关 类 。 

© 第 18 一 45 行 重 写 onCreate() 方 法 。 其 中 ,第 24 行 从 资源 中 获取 ID 为 List View01 的 
ListView 对 象 list; 第 27 一 32 行 创建 了 SimpleAdater 对 象 listItemAdapter, 并 生成 适配器 的 
Item 和 动态 数组 对 应 的 元 素 ; 第 35 行为 list 添加 适配器 ,并 显示 其 内 容 ; 第 38 一 44 行为 ist 
添加 一 个 单 击 监听 器 。 

(D 在 第 27 一 32 行 创建 的 SimpleAdapter 实例 中 ,第 二 个 参数 使 用 的 是 一 个 自 定义 的 
getData() 方 法 ,该 方法 返回 一 个 ArrayList IK., EX getData() 方 法 在 第 48 一 76 行 。 其 中 
第 49 行 创建 一 个 ArrayList 对 象 listitem; 第 50 行 创建 一 个 HashMap X% map, 这 个 map 
内 有 三 组 键 - 值 对 ,它们 分 别 是 img、title 和 info, 因 为 img 键 对 应 的 值 是 一 个 图 片 资 源 ,所 以 
map 的 值 不 全 是 String 类 型 的 ,在 声明 时 使 用 *Map 二 String, Object map = new HashMap 
Sung. Object>();”, 这 里 的 String 指定 键 名 的 类 型 ,Object 指定 键 值 的 类 型 ; 第 52 一 54 
行为 这 个 map 相应 的 键 名 传人 相应 的 值 内 容 , 第 55 行将 map 对 象 加 入 到 listitem 列表 中 ,……: ， 
如 此 下 去 直到 所 有 的 数据 都 传人 完毕 ; 第 75 行将 赋 有 值 的 listitem 对 象 返回 。 

@ 在 第 38—44 行 设置 的 监听 中 , 重 写 了 onltemClick() 回 调 方法 。 该 方法 中 的 4 个 参数 
与 前 面 讲 到 的 onItemSelected ( ) 方 法 中 的 参数 含义 相似 。 第 41 行 创建 一 个 Map 对 象 
clkmap ,使 用 getItemAtPosition() 方 法 从 arg0( 即 ListView 对 象 ) 中 arg2 参数 所 指 的 那个 条 
目 中 获取 一 组 Map 数据 给 clkmap; 第 42 行 从 clkmap 中 取出 键 名 为 title 和 info 的 值 ,并 将 
它们 显示 在 标题 栏 中 。 
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【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity_ListViewSimpleAdt 
项 目 。 运 行 结果 满足 预期 效果 。 

但 是 有 时 候 ,ListView 不 仅 是 用 来 显示 的 ,还 需要 响应 Item 上 的 操作 事件 。 例 如 在 Item 
中 添加 了 按钮 ,这 时 , ListView 需要 能 够 响应 其 上 的 按钮 单 击 事件 ,等 等 。 如 果 使 用 
SimpleAdapter, 虽 然 可 以 在 ListView 中 显示 出 按钮 来 ,但 是 无 法 为 这 个 按钮 添加 监听 响应 。 
怎样 实现 这 样 的 应 用 呢 ? 此 时 BaseAdapter 适配器 就 派 上 用 场 了 。 

3) 使 用 BaseAdapter 适配器 

BaseAdapter 适配器 直接 继承 接口 类 Adapter,BaseAdapter 与 其 他 Adapter 有 些 不 一 样 ， 
其 他 的 Adapter 可 以 直接 在 其 构造 方法 中 进行 数据 的 设置 ,但 是 在 BaseAdapter 中 需要 实现 

-个 继承 自 BaseAdapter 的 类 ,并且 继承 BaseAdapter 之 后 ,需要 重 写 以 下 4 个 方法 ,这 4 个 
方法 如 表 5-4 所 示 。 
表 5-4 继承 BaseAdapter 类 需要 重 写 的 方法 及 说 明 


方 法 do 述 
public int getCount() 获取 此 适配器 中 所 代表 的 数据 集中 的 条 目 数 
public Object getItem(int position) 获取 数据 集中 与 指定 位 置 对 应 的 数据 项 
public long getItemId(int position) 获取 在 列表 中 与 指定 位 置 对 应 的 行 ID 
public View getView(int position, View 按 指定 的 布局 绘制 列表 中 的 每 一 个 Item 项 。 其 中 , position 表示 
convertView, ViewGroup parent) 列表 中 的 位 置 , 从 0 开始 ; convertView 是 列表 中 的 Item 要 显示 


的 View, 例 如 Spinner, ListView 中 每 一 项 要 显示 的 View; parent 
是 列表 Item 的 父 容器 ,可 以 理解 为 如 Spinner, ListView 等 控件 


ListView 绘制 的 过 程 如 下 : 首先 ,系统 在 绘制 ListView 之 前 ,将 会 先 调 用 getCount ) 方 
法 来 获取 Item 的 个 数 。 之 后 每 绘制 一 个 Item 就 会 调用 一 次 getView() 方 法 ,在 此 方法 内 就 
可 以 引用 事先 定义 好 的 XML ,或 在 getView() 方 法 内 动态 生成 显示 布局 ,来 确定 显示 的 效果 
并 返回 一 个 View 对 象 作为 一 个 Item 显示 出 来 。 如 果 getCount() 返 回 值 为 0, 列表 将 不 显示 ， 
如 果 返 回 值 为 1, 则 只 显示 一 行 。 也 正 是 在 这 个 过 程 中 完成 了 适配器 的 主要 转换 功能 ,把 数据 
和 资源 以 开发 者 想 要 的 效果 显示 出 来 。 在 定义 ListView 时 ， 
getCount() 和 getView() 方 法 直接 描述 了 ListView 的 显示 效 
果 , 而 getltem() 和 getItemld() 方 法 将 在 调用 ListView 的 响 
应 方法 的 时 候 会 被 调用 到 , 相 比 之 下 ,后 两 者 没有 前 两 种 方法 
重要 ,在 案例 中 有 时 候 省 略 了 其 重 定义 的 内 容 。 所 以 要 保证 
ListView 的 各 个 方法 有 效 ,这 两 个 方法 也 要 重 写 。 例 如 : 如 
果 没 有 完成 getItemld( ) 方 法 的 功能 实现 , 当 调 用 List View 的 
getItemIdAtPosition() 方 法 时 将 会 得 不 到 想 要 的 结果 ,因为 该 
方法 就 是 调用 了 对 应 的 适配器 的 getItemld() 方 法 。 下 面 通 
过 一 个 案例 来 学 习 使 用 BaseAdapter 来 绑 定 ListView 的 
数据 。 

【案例 5.8】 使 用 BaseAdapter 适配器 为 ListView 绑 定 
数据 ,并 且 动 态 定义 显示 效果 。 使 得 案例 5. 7 的 ListView 增 图 5-12 初始 运行 时 显示 的 
加 下 列 特性 : 每 个 Item 添加 一 个 按钮 控件 ,如 图 5-12 所 示 ; Hippie 
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当 滚动 时 在 标题 栏 显示 其 网 址 信息 ,如 图 5-13 所 示 ; 当 单 击 每 个 条 目 中 的 按钮 时 ,在 标题 栏 
显示 单 击 的 条 目 ID 和 网 址 信息 ,如 图 5-14 所 示 。 


图 5-13 ”执行 滚动 操作 ,显示 相关 信息 图 5-14 单 击 条 目 中 按钮 ,显示 相关 信息 


【说 明 】 在 本 例 中 ,使 用 动态 生成 显示 布局 的 方式 ,需要 在 BaseAdapter 的 类 对 象 定义 中 重 
写 getView() 方 法 ,并 在 该 方法 内 动态 创建 布局 对 象 以 及 其 内 的 控件 对 象 。 并 且 在 BaseAdapter 
的 类 对 象 定义 中 需要 为 每 一 条 目 中 的 按钮 添加 按钮 单 击 监听 方法 OnClickListenerO 。 

为 BaseAdapter 提供 的 数据 源 全 部 放 在 一 个 数组 描述 文件 和 字符 串 描述 文件 中 ,在 代码 
中 使 用 getResources(). getldentifier() 方 法 ,通过 资源 名 来 获取 这 些 数据 的 ID, 并 加 载 到 适 配 
器 中 。 

为 该 List View 对 象 添 加 滚动 监听 OnItemSelectedListener O , 重 写 onItemSelected () 回 
调 方法 。 在 onltemSelected () 方 法 内 执行 获取 Item 的 信息 ,并 将 其 显示 在 标题 栏 中 操作 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_ListViewBaseAdt 的 Android 项 目 。 
其 应 用 程序 名 为 ListViewBaseAdt, 包 名 为 cn. com. sgmsc.. listviewbaseadt. Activity 组 件 名 
为 ListViewBaseAdtActivity。 

(2) 准备 图 片 资源 。 将 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(3) 准备 字符 串 资源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 
2 «resources?» 


3 

4 < string name = "hello"» Hello World, ListViewBaseAdtActivity!«/string» 
5 < string name = "app name"» ListViewBaseAdt </string > 

6 

7 < string name = "baidu"> 百 度 </string> 

8 < string name = "sina"> 新 浪 </string> 

9 < string name = "tencent"> 腾 讯 </string> 

10 < string name = "netease"> 网 易 </string> 

11 < string name = "baiduurl"» http://www. baidu. con/«/string» 

12 < string name = "sinaurl"» http://www. sina. com. cn/«/string? 


13 < string name = "tencenturl"» http://www. qq. com/«/string» 


125 


\ A 


A Android 应 用 开发 教程 


14 < string name = "neteaseurl"» http://www. 163. com/</string> 
15 
16 </resources > 


第 7 一 14 行 声明 了 4 对 字符 串 信息 ,它们 分 别 是 公众 网 络 的 名 称 和 对 应 首页 网 址 。 
(4) 创建 颜色 资源 。 创 建 并 编写 res/values 目录 下 的 颜色 描述 文件 colors. xml, 代 码 如 
下 所 示 。 
<?xml version = "1.0" encoding = "utf - 8"?> 
< resources > 
< color name = "white"># FFFFFFFF </color > 
< color name = "red"> # FFFD8D8D «/color > 
< color name = "blue"># FF8D9DFD «/color > 
X/resources > 
Co 创建 数组 资源 。 创 建 并 编写 res/values 目录 下 的 数组 描述 文件 arrs. xml, 代 码 如 下 
所 示 。 


au wm wm 


1«?xnl version= "1.0" encoding = "utf - 8"?> 
2 < resources > 

3 < string- array name = "images"? 

4 < item> tb_baidu </item> 

5 <item> tb_sina</item> 

6 < item» tb tencent </item> 

7 < item» tb netease </item> 

8 «/string- array? 

9 < string- array name = "titles" 


10 < item> baidu </item> 

11 < item> sina </item> 

12 < item> tencent </item> 
13 < item> netease </item> 

14 «/string - array > 

15 < string- array name = "infos"> 
16 < item> baiduurl </item> 
17 < item> sinaurl </item> 
18 < item> tencenturl </item> 
19 < item» neteaseurl </item> 
20 </string- array» 


21 </resources > 


(D 第 3 一 8 行 声明 了 一 组 图 片 资源 的 id 名 数组 images。 
© 第 9 一 14 行 声明 了 一 组 内 容 : 网 站 名 称 的 字符 串 资源 的 ID 名 数组 titles, 
© 58 15—20 行 声明 了 一 组 内 容 : 网 站 地 址 的 字符 串 资源 的 ID 名 数组 infos. 
(6) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 listv_ba. xml, 并 编辑 之 。 
代码 如 下 所 示 。 
<?xml version = "1.0" encoding = "utf 一 8"?> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:id- "(9 + id/LinearLayout0l" 
android:layout width- "fill parent" 


android:layout height = "fill parent" 
E 


o-20UPBUNn^»^ 


€ ListView 
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android:id- "(à + id/ListView02" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 


14 «/LinearLayout > 


CD 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. listviewbaseadt 包 下 的 List ViewBaseAdt Activity. 
java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgnsc. listviewbaseadt; 


import android. app. Activity; 

import android. os. Bundle; 

import android. view. Gravity; 

import android. view. View; 

import android. view. ViewGroup; 

import android. view. ViewGroup. LayoutParams; 
import android. widget. AdapterView; 

import android. widget. BaseAdapter; 

import android. widget. Button; 

import android. widget. Gallery; 

import android. widget. ImageView; 

import android. widget. LinearLayout; 

import android. widget. ListView; 

import android. widget. TextView; 

import android. widget. AdapterView. OnItemSelectedListener; 


public class ListViewBaseAdtActivity extends Activity ( 


(2 Override 
public void onCreate(Bundle savedInstanceState) ( 


super. onCreate(savedInstanceState); 
setContentView(R.layout.listv ba); 
ListView lv = (ListView)this. findViewById(R. id. ListView02); // 初 始 化 ListView 


BaseAdapter ba = new BaseAdapter()( // 为 ListView 准备 内 容 适 配器 


// 所 有 图 片 资 源 名 (tb_baidu,tb_sina ,tb_ tencent ,tb_netease) 的 数组 
String[] images = getResources().getStringArray(R. array. images) ; 
// 所 有 标题 资源 名 (baidu, sina, tencent , netease) hi $H 

String[] titles = getResources().getStringArray(R. array. titles); 

// 所 有 网 址 资源 名 (baiduurl .sinaurl ,tencenturl ,neteaseurl) 的 数组 
String[] infos = getResources() . getStringArray(R. array. infos); 


public int getCount() (return images.length;) // 返 回 数 组 的 大 小 , 即 数组 元 素 个 数 
public Object getItem(int arg0) ( return null; } 
public long getItemId(int arg0) ( return 0; } 
// 动 态 生 成 每 个 下 拉 项 对 应 的 View, 每 个 下 拉 项 View 由 LinearLayout 中 包含 一 个 
//ImageView, Wi 4- Pii (f) LinearLayout 构成 ,其 中 一 个 包含 两 个 TextView, 另 一 个 中 包 
// 含 一 个 按钮 
public View getView( int arg0, View argl, ViewGroup arg2) { 

LinearLayout 110 = new LinearLayout(ListViewBaseAdtActivity. this); 

// 初 始 化 LinearLayout 
110. setOrientation(LinearLayout. HORIZONTAL) ; // 设 置 朝向 
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44 
45 


46 
47 
48 
49 
50 
51 
52 


53 
54 
55 
56 
37 
58 
59 


60 
61 
62 
63 
64 
65 
66 
67 
68 


69 
70 
71 
T2 
73 
74 
75 
76 
77 


78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 


ImageView img = new ImageView(ListViewBaseAdtActivity. this); 
// 初 始 化 ImageView 
img. setImageDrawable(getResources().getDrawable( 
getResources() . getIdentifier( images[arg0], "drawable",getPackageName()))) ; 
img. setLayoutParams(new Gallery.LayoutParams(49,50)); 
img. setPadding(5, 5, 5, 5); 
110. addView( img); // 添 加 到 LinearLayout 中 


LinearLayout 111 = new LinearLayout(ListViewBaseAdtActivity.this); 
// 初 始 化 LinearLayout 
111. setOrientation(LinearLayout. VERTICAL); // 设 置 朝向 
111. setLayoutParams(new LinearLayout. LayoutParams 
(LayoutParams. WRAP_CONTENT, LayoutParams.WRAP CONTENT)); 


TextView tit = new TextView(ListViewBaseAdtActivity.this); // 初 始 化 TextView 
tit.setText(getResources().getText( 
getResources().getIdentifier(titles[arg0], "string",getPackageName()))) ; 


// 设 置 内 容 
tit.setLayoutParams(new LayoutParams( // 设 置 宽度 ,高 度 
Linearlayout. LayoutParams. WRAP CONTENT, Linearlayout. LayoutParams. WRAP CONTENT)); 
tit.setTextSize(22); // 设 置 字体 大 小 
tit.setTextColor(getResources().getColor(R.color.white));  // 设 置 字体 颜色 
111. addView(tit); // 添 加 到 LinearLayout 中 


TextView inf = new TextView(ListViewBaseAdtActivity.this); // 初 始 化 TextView 
inf.setText(getResources().getText( 
getResources() . getIdentifier(infos[arg0], "string",getPackageName()))) ; 


// 设 置 内 容 
inf. setLayoutParams(new LayoutParams( // 设 置 宽度 ,高 度 
LinearLayout. LayoutParams. WRAP_OONTENT, Linearlayout. LayoutParams. WRAP_CONTENT) ) ; 
inf.setTextSize(13); /设置 字体 大 小 
inf.setTextColor(getResources().getColor(R.color.white)); ”// 设 置 字体 颜色 
111. addView(inf); // 添 加 到 LinearLayout 中 
110. addView(111); // 添 加 到 LinearLayout 中 


LinearLayout 112 = new LinearLayout(ListViewBaseAdtActivity.this); 
// 初 始 化 LinearLayout 
ll2.setOrientation(LinearLayout.HORIZONTAL); ”// 设 置 朝向 
112. setLayoutParams(new LinearLayout. LayoutParams 
(LayoutParams.FILL PARENT, LayoutParams.WRAP CONTENT)); 
112. setPadding(3, 0, 3, 0); //setPadding 参数 : (left, top, right, bottom) 
112. setGravity(Gravity. RIGHT); 


Button btn = new Button(ListViewBaseAdtActivity. this); // 初 始 化 Button 
btn. setLayoutParams(new LinearLayout. LayoutParams(50, LayoutParams.WRAP CONTENT)); 
btn. setText(" 显 示 网 址 "); 


btn. setId(arg0); // 设 置 Button 的 ID 
// 设 置 按钮 的 监听 器 
btn. setOnClickListener(new View. OnClickListener() ( 

(GOverride 


public void onClick(View v) { 
StringBuilder cb = new StringBuilder(); // 用 StringBuilder 动态 生成 信息 
cb. append(" 单 击 第 " + Integer.toString(v.getId() *1) + "项 ,网 址 为 : "); 
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94 // Cb. append(" 单 击 第 " + String. valueOf(v.getId() + 1) + "项 ,网 址 为 : "); 
95 cb. append(getResources( ) . getText( 
96 getResources ( ). getIdentifier ( infos [ v. getId ( )], " string", 
getPackageName() ) ) ) ; 
97 String clkstr = cb. toString(); 
98 setTitle(clkstr); 
99 } 
100 ns 
101 112. addView(btn); // 将 btn 添加 到 112 中 
102 
103 110. addView(112); // 将 112 添加 到 110 中 
104 
105 return 110; 
106 ) 
107 }; 
108 
109 lv. setAdapter (ba) ; // 为 ListView 设置 内 容 适配器 
110 
111 lv. setOnItemSelectedListener( // 设 置 选项 选中 的 监听 器 
112 new OnItemSelectedListener(){ 
113 public void onItemSelected( AdapterView <?> arg0, View argl, int arg2, long arg3) { 
114 // 重 写 选项 被 选中 事件 的 处 理 方法 
115 
116 LinearLayout 110 = (LinearLayout)argl; 
// 获 取 当 前 选中 选项 对 应 的 LinearLayout 
117 LinearLayout 111 = (LinearLayout)110.getChildAt(1); 
// 获 取 其 中 的 子 LinearLayout 
118 
119 StringBuilder sb = new StringBuilder(); // Fl StringBuilder 动态 生成 信息 
120 TextView tv1 = (TextView)111.getChildAt(0); // 获 取 其 中 的 TextView 
121 sb. append(tvi.getText() + "的 网 址 为 : "); 
122 TextView tv2 = (TextView)111.getChildAt(1); // 获 取 其 中 的 TextView 
123 sb. append(tv2. getText()); 
124 String stemp = sb. toString(); 
125 setTitle(stemp); 
126 
127 ) 
128 
129 public void onNothingSelected(AdapterView «?» arg0) ( } 
130 ) 
131 ); 
132 
133 } 
134 
135 } 


O 第 3—17 行 引入 代码 中 用 到 的 Android 中 的 相关 类 。 

© 第 27—107 行 创建 了 一 个 BaseAdapter 的 类 对 象 ba, 在 其 中 , 重 定义 ba 中 的 getCount()， 
getItem() ,getItemId() ,getView() 方 法 ,并 添加 按钮 OnClickListener 监听 等 。 

@ 第 29 一 34 行 定义 三 个 字符 串 数组 ,分 别 用 于 存放 图 片 . 网 名 、 网 址 资源 的 ID 名 。 

@ 第 36 行 重 写 getCount() 方 法 ,返回 数组 的 大 小 ,用 于 确定 ListView 的 条 目 数 。 

© 第 37 行 重 写 getItem() 方 法 。 
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@ 第 38 行 重 写 getItemId() 方 法 。 

CD 第 41 一 106 行 重 写 getView() 方 法 。 

第 42—43 行 创建 一 个 LinearLayout 布局 对 象 10 ,并 设置 为 横向 的 。 第 45 一 49 行 创 
建 一 个 ImageView 控件 对 象 img, 其 中 第 46 行使 用 了 4 个 方法 为 img 获取 图 片 资 源 。 其 中 使 
用 方法 setImageDrawable(ImageView) 将 指定 的 图 片 赋予 img 对 象 中 并 显示 出 来 ; 使 用 方法 
getResources( ). getDrawable ( ImageViewld) 从 指定 的 资源 ID 中 获得 图 片 资源 ;而 
getResources(). getIdentifier(String，String，String) 方 法 是 从 指定 的 应 用 包 下 , 按 指定 资源 
名 获得 ID 号 ,如 果 没 有 找到 指定 的 资源 则 返回 0, 这 里 第 一 个 参数 资源 ID 名 ,第 二 个 为 资源 
的 类 型 ,第 三 个 为 应 用 所 在 的 包 名 ; 使 用 方法 getPackageName() 获 得 当前 所 在 的 包 名 。 

提醒 一 下 : 

使 用 getResources() 方 法 的 注意 事项 : getResources() 方 法 的 功能 是 获取 资源 。 在 使 用 
getResources() 方 法 时 最 好 在 其 前 面 加 上 限定 前 缓 以 明确 是 谁 的 资源 , 即 ListViewBaseAdtActivity. 
this. getResources()。 不 过 ,如 果 在 类 的 onCreate() 方 法 内 使 用 getResources() ,可 以 省 略 其 限定 前 
缓 , 因 为 此 时 所 有 资源 都 被 默认 为 ListViewBaseAdtActivity 类 的 资源 。 由 于 篇 幅 所 限 ,在 本 
例 中 都 省 略 了 “ListViewBaseAdtActivity. this", 

千 万 要 记 住 不 能 在 onCreate 之 前 使 用 getResources() 方 法 。 

© 第 48 行 设置 图 片 的 宽度 和 高 度 值 ,以 像素 为 单位 。 

D 第 49 行 设置 图 片 与 四 周 的 间距 为 5。 

D 第 50 行将 img 对 象 添加 到 名 为 110 的 LinearLayout 布局 中 。 

(2 第 52 一 55 f1 8| —- VIR RJ LinearLayout 布局 111 ,并 设置 为 纵向 ,第 54 一 55 行 设置 
宽度 和 高 度 。 动 态 设置 子 控件 的 宽度 ,高 度 的 方法 如 下 ,其 中 第 一 个 参数 为 宽度 ,第 二 个 参数 
为 高 度 : 

setLayoutParams (new LinearLayout. LayoutParams ( LayoutParams. WRAP CONTENT, LayoutParams. WRAP_ 

CONTENT) ) ; 

这 条 语句 其 实 是 子 对 父 而 言 的 , 即 在 父 布局 下 的 子 控件 需要 设置 这 条 请 句 。 这 时 ,“new 
LinearLayout. LayoutParams” 说 明 其 父 布局 为 一 个 LinearLayout 布局 。 

图 第 57 一 64 行 和 66 一 73 行 创 建 了 两 个 TextView 对 象 ,并 把 它们 添加 到 111 布局 中 。 

O 58 75 £r 111 添加 到 ll0 中 。 

O 58 77—82 行 创建 新 的 LinearLayout 对 象 12。 第 84 一 86 行 在 ll2 内 创建 一 个 按钮 对 
象 btn。 第 87 行将 被 单 击 按钮 所 在 条 目 位 置 设 置 为 该 按钮 的 ID. 

® 第 89 一 100 行为 btn 添加 OnClickListener() 监 听 。 在 其 OnClick() 回 调 事件 中 使 用 
StringBuilder 对 象 拼接 字符 串 。 其 中 ,Integer. toString(v. getId() 十 1) 或 String. valueOf( v. 
getId() 十 1) 是 获取 View 对 象 的 ID 号 ,这 时 的 View 即 为 btn。 第 95 一 96 行 是 btn 的 ID 所 
在 条 目 中 获取 infos 数组 元 素 所 指定 的 文本 内 容 , 并 添加 到 StringBuilder 对 象 cb 中 。 

问 一 下 : 

StringBuilder 是 什么 类 型 的 数据 ? 

StringBuilder 与 String 类 型 相似 ,都 用 来 存放 字符 串 数 据 。 在 做 字符 串 拼 接 时 ,String 会 
产生 一 个 新 的 实例 ,而 StringBuilder 则 不 会 。 所 以 在 大 量 字符 串 拼 接 或 频繁 对 某 一 字符 串 进 
行 操作 时 最 好 使 用 StringBuilder, 不 要 使 用 String。 
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加 $ 105 行 返回 110 布局 对 象 ,完成 BaseAdapter 类 对 象 ba 的 创建 。 

B 第 109 行为 ListView 对 象 lv 添加 适配器 ba. 

O 第 111 一 132 行为 lv 对 象 添加 滚动 监听 器 。 第 113 一 128 行 重 写 onItemSelected() 方 
法 。 在 重 写 中 通过 (LinearLayout) arg) 获取 父 布局 110; 通过 (LinearLayout)110. getChildAt C1) 
获取 其 内 的 第 二 个 对 象 , 即 第 一 个 内 嵌 的 LinearLayout 对 象 11; 通过 (TextView ) I1. 
getChildAt(0) 获取 第 一 个 文本 对 象 tv15 通过 tvl. getText() 获 取 tvl 中 的 值 ; 通过 
CTextView)lll. getChildAt(1) 获 取 第 一 个 文本 对 象 tv2 ,通过 tv2. getText() 获 取 tv2 中 的 值 ; 
将 所 得 文本 字符 串 拼接 在 StringBuilder 对 象 sb 中 ,并 显示 在 标题 栏 中 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity_ListViewBaseAdt 项 
目 。 运 行 结果 满足 预期 效果 。 


4. GridView 


GridView 类 位 于 android. widget 包 下 ,该 视图 将 其 他 控件 以 可 滚动 的 二 维 网 格 显示 出 
来 ,每 一 个 网 格 项 (Item) 的 显示 内 容 来 自 于 与 之 相关 的 ListAdapter。GridView 是 一 种 较 常 
见 的 控件 ,一 般 用 于 显示 多 个 图 片 内 容 , 例 如 九宫 图 等 。 
GridView 类 的 常用 的 属性 和 对 应 方法 如 表 5-5 所 示 。 
表 5-5 GridView 常用 的 属性 及 对 应 方法 说 明 
B 性 5 法 描 述 
android:columnWidth setColumnWidth (int) 设置 GridView 的 列 宽度 


设置 GridView 中 的 内 容 在 其 内 的 位 置 。 可 选 
的 值 有 : top. bottom, left, right, center vertical, 


android; gravity setGravity (int) ` 7 j $ í 
fill. vertical, center horizontal, fill horizontal, 


center ,fill clip_vertical。 可 以 多 选 ,用 “1” 分开 
android:horizontalSpacing setHorizontalSpacing (int) ”设置 两 列 之 间 的 间距 


android:numColumns setNumColumns (int) 设置 GridView 的 列 数 
android: stretchMode setStretchMode (int) 设置 GridView 的 缩放 模式 
android: verticalSpacing setVerticalSpacing(int) 设置 两 行 之 间 的 间距 


GridView 的 用 法 很 多 ,下 面 通过 一 个 完整 案例 来 介绍 如 何 使 用 GridView 实现 九宫 图 。 

【案例 5.9】 使 用 GridView 实现 九宫 图 ,每 个 网 格 中 图 片 在 上 方 , 图 片 的 编号 在 下 方 。 

【说 明 】 GridView 的 用 法 与 ListView 极其 类 似 。 在 本 例 中 ,使 用 自 定义 一 个 
PictureAdapter 类 继承 BaseAdapter, 再 供 GridView 使 用 。 与 案例 5. 8 不 同 的 是 ,本 例 将 不 采 
用 动态 创建 布局 对 象 及 其 内 的 控件 对 象 ,而 是 采用 预先 定义 好 的 XML 布局 文件 方式 。 

如 果 在 定义 BaseAdapter 子 类 时 要 使 用 res/layout 目录 下 的 XML 布局 文件 ,Android 提 
供 了 一 个 专门 的 类 LayoutInflater。LayoutInflater 的 作用 类 似 于 findViewByld O ,不 同 点 是 
LayoutInflater 是 用 来 找 res/layout 目录 下 的 XML 布局 文件 ,并 且 实 例 化 ; 而 findViewById() 则 
是 找 具体 某 一 个 XML 下 的 具体 widget 控件 (如 : Button, TextView 等 ) 。 

为 该 GridView 对 象 添加 滚动 监听 OnItemClickListener () , 重 写 onItemClick () 回 调 方 
法 ,在 该 方法 中 执行 将 单 击 的 网 格 中 的 图 片 编号 显示 在 标题 栏 中 的 操作 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_GridView 的 Android 项 目 。 其 应 用 
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程序 名 为 GridView , 包 名 为 cn. com. sgmsc. gridview, Activity 组 件 名 为 GridViewActivity, 
(2) 准备 资源 。 将 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 这 一 组 图 片 文 
件 名 为 grid_view_01~grid_view_18, 有 些 文件 是 . gif 格式 ,有 些 是 . jpg 格式 。 
(3) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 grid_view. xml, 并 编辑 之 。 
代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 


2 

3 <GridView xmlns:android= "http://schemas.android. com/apk/res/android" 
4 android:id = "(à + id/gridview" 

5 android:layout width- "fill parent" 

6 android:layout height = "fill parent" 

7 android:numColumns = "auto fit" 

8 android:verticalSpacing - "10dp" 

9 android:horizontalSpacing = "l0dp" 


10 android:columnWidth - "90dp" 

11 android: stretchMode = "columnWidth" 
12 android:gravity = "center" 

13 /> 


CD 第 4 行 声 明了 这 个 GridView 控件 名 为 gridview, 

@ 第 7 行 设置 该 GridView 的 列 数 , 此 时 “auto_fit" 表 示 GridView 的 列 数 设 置 为 自动 。 

© 58 11 行 设 置 该 GridView 的 缩放 模式 为 按 列 宽度 缩放 。 

(4) 设计 GridView 的 单元 格 布 局 。 在 res/layout 目录 下 创建 一 个 名 为 pic_item. xml 的 
布局 文件 ,该 文件 为 GridView 的 每 一 个 Item 对 象 布 局 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 «LinearLayout 

3 xmlns:android = "http://schemas. android. con/apk/res/android" 
4 android: id= "(9 + id/root" 

5 android:orientation = "vertical" 

6 android:layout width = "wrap content" 

7 android:layout height = "wrap content" 

8 android:layout marginTop = "5dp" 

9 


> 
10 < ImageView 

it android: id = "(9 + id/image" 

12 android:layout width = "85dp" 

13 android:layout height - "85dp" 

14 android:layout gravity = "center" 

15 android:scaleType - "centerCrop" 

16 android: padding = "4dp" 

17 /> 

18 < TextView 

19 android:id- "(9 + id/title" 

20 android:layout width- "wrap content" 
21 android:layout height - "wrap content" 
22 android:layout gravity = "center" 

23 /> 


24 </LinearLayout > 


(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. gridview 包 下 的 GridViewActivity. java X 
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件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. gridview; 


import java. util. ArrayList; 
import java. util. List; 


import android. app. Activity; 

import android. content. Context; 
import android. os. Bundle; 

import android. view. LayoutInflater; 
import android. view. View; 

import android. view. ViewGroup; 
import android. widget. AdapterView; 
import android. widget. BaseAdapter; 
import android. widget. GridView; 
import android. widget. ImageView; 
import android. widget. TextView; 
import android. widget. AdapterView. OnItemClickListener; 


public class GridViewActivity extends Activity { 
private GridView gridView; 
// 图 片 10 数组 


private int[] imgs = new int[] ( 


R.drawable.grid view 01, R.drawable.grid view 02, R.drawable.grid view 03, 
R.drawable.grid view 04, R.drawable.grid view 05, R.drawable.grid view 06, 
R.drawable.grid view 07, R. drawable. grid view 08,R.drawable.grid view 09, 
| view 10, R. drawable.grid view 11,R.drawable.grid view 12, 
R.drawable.grid view 13, R.drawable.grid view 14,R.drawable.grid view 15, 
R.drawable.grid view 16, R.drawable.grid view 17,R.drawable.grid view 18 


R. drawable. gr: 


}; 
// 图 片 编 号 数组 
private String[] tits 


= new String[] { 


"picture 01", "picture 02", "picture 03", 
"picture 04", "picture 05", "picture 06", 
"picture 07", "picture 08", "picture 09", 
"picture 10", "picture 11", "picture 12", 
"picture 13", "picture 14", "picture 15", 
"picture 16", "picture 17", "picture 18" 


h 


@Override 


public void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R. layout. griv_view); 


gridView = (GridView) findViewById(R. id. gridview); 
PictureAdapter adapter = new PictureAdapter(tits, imgs, this); 
gridView. setAdapter(adapter); 


gridView. setOnItemClickListener(new OnItemClickListener() { 


public void onItemClick( AdapterView <?> parent, View v, int position, long id) { 


if (position«10) ( 


setTitle(" 单 击 的 图 片 是 : picture 0" + (position*1)); 


}else { 


}; 


setTitle(" 单 击 的 图 片 是 : picture " + (position+1)); 
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n; 


60 // 自 定义 PictureAdapter 适配器 
61 class PictureAdapter extends BaseAdapter{ 


private LayoutInflater inflater; 
private List «Picture» pictures; 


public PictureAdapter(String[] titles, int[] images, Context context) ( 
super(); 
pictures = new ArrayList < Picture»(); 
inflater = LayoutInflater. from(context); 
for (int i = 0; i< images. length; i++) 


{ 
Picture pic = new Picture(titles[i], images[i]); 
pictures. add(pic); 
) 
l 
(QOverride 


public int getCount() ( 
if (null != pictures) { 
return pictures. size(); 
) eise ( 
return 0; 


} 
@Override 
public Object getItem(int position) ( 
return pictures. get(position); 
) 
@Override 
public long getItemId( int position) { return position; } 
@Override 
public View getView( int position, View convertView, ViewGroup parent) 
{ 
ViewHolder viewHolder; 
if (convertView == null) 
( 
convertView = inflater. inflate(R.layout.pic item, null); 
viewHolder - new ViewHolder(); 
viewHolder.title = (TextView) convertView. findViewById(R. id. title); 
viewHolder.image = (ImageView) convertView. findViewById(R. id. image); 
convertView. setTag( viewHolder); 
] else 
{ 
viewHolder = (ViewHolder) convertView.getTag(); 
} 
viewHolder. title. setText(pictures. get(position).getTitle()); 
viewHolder. image. setImageResource( pictures. get( position). getImageId() ); 
return convertView; 
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110 
111 // 定 义 类 ViewHolder 
112 class ViewHolder { 


113 public TextView title; 
114 public ImageView image; 
115 } 

116 


117 // 定 义 类 Picture 
118 class Picture { 


119 private String title; 

120 private int imageId; 

121 

122 public Picture() ( 

123 super(); 

124 ) 

125 

126 public Picture(String title, int imageId) ( 

127 super(); 

128 this.title - title; 

129 this. imageId = imageld; 

130 ) 

131 

132 public String getTitle() ( return title; } 

133 public void setTitle(String title) ( this.title = title; } 
134 public int getImageld() ( return imageld; } 

135 public void setImageld(int imageld) ( this. imageld = imageld; } 
136 } 


O 第 3~17 行 引入 代码 中 用 到 的 Java 和 Android 中 的 相关 类 。 

© 第 19 一 58 行 定义 GridViewActivity 类 。 其 中 ,第 21 一 38 行 定义 了 网 格 中 需要 显示 的 
图 片 ID 数组 和 图 片 编号 名 数组 。 第 40 一 57 行 重 写 onCreate() 方 法 ,第 45 行 通过 一 个 自 定义 
的 适配器 PictureAdapter 创建 适配器 对 象 adapter, 第 48—56 行为 GridView 对 象 gridview 添 
加 OnItemClickListener 监听 ,并重 写 OnItemClick() 方 法 。 

© 第 61 一 109 行 自 定 义 一 个 适配器 PictureAdapter, 它 继承 自 BaseAdapter。 第 65 一 74 
行 是 定义 类 PictureAdapter 的 构造 方法 。 第 67 行 创 建 一 个 ArrayList 对 象 , 并 定义 这 个 
pictures 是 由 以 Picture( Picture 是 一 个 自 定义 的 类 ,在 代码 后 面 会 给 出 定义 ) 为 元 素 类 型 的 
ArrayList; 第 68 行 获取 pictures 中 每 个 Item 的 布局 ; 第 69—73 行将 指定 的 Picture 类 型 元 
素 一 个 一 个 地 添加 到 这 个 数组 列表 pictures 中 。 在 定义 子 类 PictureAdapter 时 还 需要 重 写 
getCount() ,getItemO ,getItemIdO ,getView() 方 法 。 

(D 别 忘 了 ,PictureAdapter 类 中 的 具体 数据 是 通过 getView() 方 法 来 实现 的 ,所 以 第 91 一 
108 行 是 为 PictureAdapter 类 实例 化 的 代码 段 。 第 96 行 通过 res/layout 目录 下 的 布局 文件 
pic item. xml 获得 每 个 网 格 的 显示 效果 ; 第 100 行为 这 个 布局 添加 一 个 ViewHolder 
(ViewHolder 是 一 个 自 定义 的 类 ,在 代码 后 面 会 给 出 定义 ) 类 型 的 数据 对 象 viewHolder, 这 
里 ,convertView 中 的 setTag(viewHolder) 表 示 给 convertView 添加 一 个 额外 的 数据 ,以 后 可 
以 用 getTag() 将 这 个 数据 取出 来 ; 第 105 行为 viewHolder 对 象 赋予 相应 的 图 片 编号 字符 串 
并 显示 ; 第 106 行为 viewHolder 对 象 赋予 相应 的 图 片 并 显示 。 

© 第 112—115 行 定 义 ViewHolder 类。 

© 第 118—136 行 定 义 Picture 类 。 其 中 第 122 一 124, 第 126—130 行 是 该 自 定义 类 的 两 
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x 


个 构造 方法 ,第 132—135 行 是 该 自 定义 类 的 几 个 方法 , 供 该 类 对 象 调 

【运行 结果 】〗 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 GridView 项 目 。 初 
始 运行 结果 如 图 5-15 所 示 , 单 击 了 GridView 控件 的 某 个 网 格 后 ,在 标题 栏 显示 相应 的 信息 如 
图 5-16 所 示 。 
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图 5-15 初始 运行 时 的 显示 界面 图 5-16 单 击 网 格 内 的 图 片 时 显示 界面 


5. Gallery 
Gallery 类 位 于 android. widget 包 下 , 它 是 一 种 较 常 见 的 控件 ,是 一 种 水 平 滚动 的 列表 ,一 
般 用 来 显示 图 片 等 资源 , 它 可 以 使 图 片 在 屏幕 上 水 平地 滑 来 滑 去 。Gallery 中 的 图 片 同样 来 自 
适配器 。 
Gallery 类 的 常用 属性 和 对 应 方法 如 表 5-6 所 示 。 
55-6 Gallery 常用 的 属性 及 对 应 方法 说 明 


B 性 5 È 描 述 
android:animationDuration — setAnimationDuration (int) 设置 动画 过 渡 的 时 间 
android: gravity setGravity (int) 设置 在 父 控件 中 的 对 齐 方式 
android:unselectedAlpha setUnselectedAlpha (float) 设置 选中 图 片 的 透明 度 
android:spacing setSpacing(int) 设置 图 片 之 间 的 间距 


下 面 通过 一 个 完整 案例 来 介绍 Gallery 的 使 用 方法 。 

【案例 5.10】 使 用 Gallery 实现 一 个 画廊 ,该 画廊 展示 IT 业 一 些 著 名 人 士 照 片 。 

【说 明 】 本 例 使 用 BaseAdapter 为 GridView 提供 数据 资源 。 方 法 与 案例 5. 8 相似 。 

【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity Gallery 的 Android 项 目 。 其 应 用 程 
序 名 为 Gallery, 包 名 为 cn. com. sgmsc. gallery. Activity 组 件 名 为 GalleryActivity。 

(2) 准备 图 片 。 将 图 片 资 源 复 制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(3) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 gallery. xml, 并 编辑 之 。 
代码 如 下 所 示 。 
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1 <?xml version= "1.0" encoding = "utf - 8"?» 


2 «LinearLayout xmlns:android = "http: //schemas. android. con/apk/res/android" 


3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:gravity = "center vertical" 

7 > 

8 «Gallery 

9 android: id = "(à + id/gallery01" 

10 android:layout width- "fill parent" 
11 android:layout height = "wrap content" 
12 android:spacing = "16dip" 

13 android:unselectedAlpha - "1" /» 


14 «/LinearLayout » 


第 13 行 设置 被 选中 项 的 不 透明 度 为 100% , 即 最 清晰 显示 照片 。 


(4) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. gallery 包 下 的 GalleryActivity. java 文件 ， 


并 编辑 之 。 代 码 如 下 所 示 。 
package cn. com. sgmsc. gallery; 


3 

2 

3 import android. app. Activity; 

4 import android. os. Bundle; 

5 import android. view. View; 

6 import android. view. ViewGroup; 

7 import android. widget. AdapterView; 
8 import android. widget. BaseAdapter; 
9 import android. widget. Gallery; 

10 import android. widget. ImageView; 
11 import android. widget. AdapterView. OnItemClickListener; 


13 public class GalleryActivity extends Activity { 
14 int[] imageIDs= { 


15 R. drawable. turing, R. drawable. edgar, R. drawable. torvalds,R. drawable. bill,R.drawable. andy 
16 }; 

17 

18 (QOverride 

19 public void onCreate(Bundle savedInstanceState) ( 
20 super. onCreate(savedInstanceState); 

21 setContentView(R. layout. gallery); 

22 Gallery gl = (Gallery)this. findViewById(R. id. gallery01); 
23 

24 // 创 建 适 配器 对 象 ba 

25 BaseAdapter ba = new BaseAdapter( ) ( 

26 (S Override 

27 public int getCount() { 

28 return imageIDs. length; 

29 } 

30 @Override 

31 public Object getItem(int arg0) ( 

32 return null; 

33 } 

34 @Override 

35 public long getItemId( int arg0) { 


36 return 0; 
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37 } 

38 @Override 

39 public View getView( int arg0, View argl, ViewGroup arg2) { 

40 ImageView iv = new ImageView(GalleryActivity. this); 

41 iv.setlImageResource(imageIDs[arg0]); 

42 iv.setScaleType(ImageView. ScaleType. FIT XY); 

43 iv.setLayoutParams(new Gallery. LayoutParams(220,216)); 

44 return iv; 

45 } 

46 m 

47 

48 gl.setAdapter(ba); 

49 

50 // 为 91 添加 单 击 监听 

51 gl.setOnItemClickListener( 

52 new OnItenClickListener()( 

53 @Override 

54 public void onltemClick(AdapterView <?> arg0, View argl, 

55 int arg2, long arg3) ( 

56 Gallery gly = (Gallery)findViewById(R. id. gallery01); 
// 创 建 一 个 Gallery X $& gly 

57 gly. setSelection(arg2); // 为 gly 设置 选中 项 

58 } 

59 } 

60 ); 

61 } 

62 ) 


(D 第 14—15 行 定义 图 片 资源 的 ID 数组 imageIDs。 

@ 第 25 一 46 行 创建 一 个 BaseAdapter 对 象 ba, 并 实例 
化 。 其 中 重 写 getCount() ,getltemO ,getItemld O .getView( ) 方 
法 。 第 40 一 43 行 是 为 这 个 ba 中 的 每 一 项 进行 赋值 的 代码 
段 ,第 42 行 设置 图 片 要 横 、 纵 向 充满 ImageView 控件 对 象 iv 
的 宽 、 高 ,第 43 行 iv 的 宽 与 高 分 别 为 220 与 216 像素 值 。 

© 第 51 一 60 行为 Gallery 对 象 gl 添加 OnItemClickListener 
监听 。 在 onItemClick() 回 调 方法 中 获取 选中 的 Gallery 的 图 片 
元 素 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 Activity Gallery 项 目 。 运 行 结果 如 图 5-17 所 示 。 

在 开发 中 , 当 需 要 绑 定 一 些 数据 展现 到 屏幕 上 时 ,就 需要 
使 用 AdapterView 来 为 控件 提供 数据 源 。AdapterView 是 
ViewGroup 的 子 类 , 它 决定 了 通过 Adapter 来 绑 定 特殊 的 数 


图 5-17 IT 名 人 画廊 显示 界面 


据 类 型 并 以 它 定 义 的 布局 来 展现 视图 。AutoCompleteTextView、Spinner、 ListView、 


GridView 和 Gallery 都 是 AdapterView 的 子 类 。 


5.2.2 其 他 与 视图 相关 的 控件 


并 不 是 所 有 展现 在 屏幕 上 的 一 组 数据 都 必须 使 用 Adapter。 有 时 候 , 需 要 显示 的 项 目 不 


多 ,但 一 屏 显示 不 下 时 ,可 以 使 用 男 外 一 些 视图 控件 来 处 理 。 
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1. ScrollView 


ScrollView 类 位 于 android. widget 包 下 , 它 继承 自 FrameLayout, 实 际 上 是 一 个 帧 布局 。 
在 ScrollView 中 可 以 添加 任意 一 个 控件 , 当 其 内 控件 的 内 容 在 一 屏幕 显示 不 完 时 , 便 会 自动 
产生 滚动 功能 ,通过 纵向 滚动 的 方式 以 显示 被 挡住 的 部 分 内 容 。ScrollView 只 支持 垂直 滚动 。 

注意 ,ScrollView 中 只 能 加 一 个 控制 ,不 能 超过 两 个 。 一 般 情况 下 ,在 ScrollView 布局 内 
添加 一 个 线性 布局 ,然后 再 将 控件 添加 到 这 个 线性 布局 中 ,这 样 就 可 以 实现 在 其 中 添加 多 个 控 
件 了 。 


2. TabHost 


TabHost 类 位 于 android. widget & F , 它 继承 自 FrameLayout, 是 一 种 帧 布局 ,在 其 中 ， 
它 包 含 多 个 布局 ,但 同一 时 刻 , 根 据 用 户 的 选择 只 显示 其 中 一 个 布局 的 内 容 。 它 是 选项 卡 的 封 
装 类 ,用 于 创建 选项 卡 窗口 。 

下 面 通过 一 个 完整 案例 来 介绍 TabHost 的 使 用 方法 。 

【案例 5. 11】 使 用 TabHost 控件 分 页 展示 IT 业 一 些 著名 人 士 信息 。 

【说 明 】 在 一 个 帧 布局 FrameLayout 内 定义 多 个 LinearLayout 布局 ,每 个 LinearLayout 
添加 一 个 名 人 的 信息 ,其 中 包括 照片 和 个 人 简介 。 

【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity TabHost 的 Android 项 目 。 其 应 用 
程序 名 为 TabHost, 包 名 为 cn. com. sgmsc. tabhost, Activity 组 件 名 为 TabHostActivity。 

(2) 准备 图 片 。 将 图 片 资 源 复 制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(3) 准备 字符 串 资源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?» 
2 «resources» 


3 

4 < string name = "hello"» Hello World, TabHostActivity!«/string» 

5 < string name = "app name"» TabHost «/string? 

6 

b < string name = "andy"» Andy Rubin Wn 

8 Andy Rubin 是 Google 移动 平台 资深 总 监 , Android 的 创始 人 之 一 。</string> 

9 < string name = "bill" Bill Joy Vn 

10 是 Java 创造 者 之 一 ,一 位 令 人 崇敬 的 软件 天 才 , 被 誉 为 软件 业 的 爱迪生 。</string> 
11 < string name = "edgar"> Edgar F. Codd An 

12 他 创造 的 关系 模型 是 关系 数据 库 的 理论 基础 。 被 誉 为 关系 数据 库 之 父 。</string> 
13 < string name = "torvalds"> Linus Torvalds \n 

14 Linus Torvalds, 一 名 芬兰 的 计算 机 天 才 , 他 是 Linux 系统 的 创始 人 。</string> 

15 < string name = "turing"> Turing Alan n 

16 Alan Turing 对 早期 计算 的 理论 和 实践 做 出 了 突出 的 贡献 ,被 誉 为 IT BH AS </string> 
17 


18 </resources > 

第 7 行 末 尾 的 “\n” 表 示 换 行 符 ,作用 是 其 后 的 文本 信息 将 在 下 一 行 显示 。 

(4) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 tabhost. xml, 并 编辑 之 。 
代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding= "utf - 8"?» 
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2 
3 
4 
5 
6 
7 
8 
9 


10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 


XFramelayout xmlns:android- "http://schemas. android. con/apk/res/android" 


android:layout width- "fill parent" 
android:layout height = "fill parent" 
< LinearLayout android: id = "(9 + id/linearLayout01" 


android:layout width- "fill parent" ^ android:layout height- "fill parent" 
android:gravity = "center horizontal"  android:orientation- "vertical"» 


< InageView 
android:id- "(à + id/tab ImageView01" 
android:scaleType - "fitXY" 
android:layout gravity = "center" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(9 drawable/andy" /> 
< TextView 
android: id = "(à + id/tab_TextView01" 
android: layout_width = "wrap_content" 
android:layout height = "wrap content" 
android:textSize - "24dip" 
android:textColor = " # f£37301" 
android: text = "(à string/andy" /» 
</LinearLayout > 
< LinearLayout android: id= "(à + id/linearLayout02" 


android: layout_width = "fill parent" android:layout_height = "fill parent" 
android:gravity = "center horizontal" android:orientation = "vertical" > 


< ImageView 
android: id= "(à + id/tab_ImageView02" 
android: scaleType = "fitXY" 
android:layout gravity = "center" 
android: layout_width = "wrap content" 
android: layout_height = "wrap_content" 
android: src = "@drawable/bill"/> 
< TextView 
android:id- "(à + id/tab TextView02" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:textSize - "24dip" 
android:textColor = " # £37301" 
android:text = "(9 string/bill"/» 
«/LinearLayout » 
< Linearlayout android: id = "(à + id/linearLayout03" 


android:layout width- "fill parent" ^ android:layout height = "fill parent" 
android:gravity = "center horizontal"  android:orientation- "vertical" 


< InageView 
android:id- "(à * id/tab ImageView03" 
android:scaleType = "fitXY" 
android:layout gravity = "center" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(d drawable/torvalds"/» 

< TextView 
android: id= "(à + id/tab TextView03" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:textSize = "24dip" 
android:textColor = " # f37301" 


57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
7i 
72 
173 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
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android:text = "@ string/torvalds"/> 
</LinearLayout > 
< Linearlayout android: id = "(à + id/linearLayout04" 
android:layout width- "fill parent" 


android:layout height = "fill parent" 


android:gravity = "center horizontal" android:orientation- "vertical"» 


< InageView 
android:id- "(à * id/tab ImageView04" 
android:scaleType = "fitXY" 
android:layout gravity = "center" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "@drawable/edgar"/> 
< TextView 
android:id- "(à + id/tab TextView04" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:textSize - "24dip" 
android:textColor = " # £37301" 
android: text = "(8 string/edgar" /» 
«/LinearLayout > 
< LinearLlayout android: id = "@ + id/linearLayout05" 


android:layout width- "fill parent" ^ android:layout height 


"fill parent" 


android:gravity = "center horizontal"  android:orientation- "vertical"» 


< InageView 
android:id- "(à * id/tab ImageView05" 
android:scaleType - "fitXY" 
android:layout gravity = "center" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/turing" /» 

<TextView 
android:id- "(à + id/tab TextView05" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:textSize - "24dip" 
android:textColor = " # £37301" 
android:text = "(9 string/turing" /» 

«/LinearLayout > 


95 «/FrameLayout > 


第 2—95 行 声明 了 一 个 FrameLayout, 其 中 声明 了 5 个 LinearLayout。 


(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. tabhost 包 下 的 TabHostActivity. java X. 


件 , 并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. tabhost; 


import android. app. TabActivity; 
import android. os. Bundle; 

import android. view.LayoutInflater; 
import android. widget. TabHost; 


public class TabHostActivity extends TabActivity ( 
private TabHost myTabhost; 


public void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 
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12 myTabhost = this.getTabHost(); // 从 Tabactivity 上 面 获取 放置 Tab 的 TabHost 
13 IayoutInflater. from (this). inflate(R. layout. tabhost, myTabhost. getTabContentView ( ), 
true); 
14 myTabhost. addTab( 
15 myTabhost. newTabSpec(" 选 项 卡 1") // 新 建 一 个 名 为 “选项 卡 1 的 Tab 标签 
16 . SsetIndicator("Andy" , getResources() . getDrawable(R. drawable. andy) ) 
// 设 置 Tab 的 标题 内 容 
17 .setContent(R.id.linearLayoutO1) // 设 置 此 Tab 页 显示 的 布局 控件 
18 LE 
19 myTabhost. addTab( 
20 myTabhost. newTabSpec(" 选 项 卡 2") 
21 . setIndicator( "Bill", getResources().getDrawable(R. drawable.bill)) 
22 . SsetContent(R. id. linearLayout02) 
23 s 
24 myTabhost. addTab( 
25 nyTabhost. newTabSpec( "选项 卡 3") 
26 . setIndicator("Torvalds", getResources().getDrawable(R. drawable. torvalds)) 
27 . setContent(R. id. linearLayout03) 
28 ) 
29 myTabhost. addTab( 
30 nyTabhost. newTabSpec(" 选 项 卡 4") 
31 . setIndicator( "Edgar", getResources().getDrawable(R. drawable. edgar)) 
32 . setContent(R. id. linearLayout04) 
33 E 
34 myTabhost. addTab( 
35 nyTabhost. newTabSpec(" 选 项 卡 5") 
36 . setIndicator("Turing", getResources().getDrawable(R. drawable. turing)) 
37 . setContent(R. id. linearLayout05) 
38 )s 
39 } 
40 ) 


(D 第 8 行 声 明 TabHostActivity 类 是 继承 TabActivity 类 的 ,所 以 第 3 £138 5| A android. 
app. TabActivity。 

© 第 12 行 从 TabActivity 上 面 获取 TabHost 对 象 myTabhost。 

© 第 13 行 从 布局 文件 tabhost. xml 中 获取 显示 模板 。 

@ 第 14 一 18 行 设 置 第 一 个 选项 卡 的 内 容 。 其 中 ,第 15 
行 是 在 myTabhost 上 添加 一 个 名 为 “选项 卡 1” 的 选项 卡 ; 第 
16 行 设置 这 个 选项 卡 的 标题 内 容 , 标 题名 为 "Andy”, 标 题 画 
片 取 自 图 片 资 源 R. drawable. andy; 第 17 行 设置 选项 卡 显示 
的 内 容 为 tabhost. xml 布局 中 的 名 为 LinearLayout01 的 线性 


布局 所 指定 的 内 容 …… 如 此 下 去 ,设置 了 后 面 4 个 选项 卡 的 
内 容 。 
【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 


行 Activity TabHost 项 目 。 运 行 结果 如 图 5-18 所 示 。 


3. ImageSwitcher 


ImageSwitcher 类 位 于 android. widget 包 下 , 它 是 Android 图 5-18 执行 选项 卡 案例 
中 控制 图 片 展示 效果 的 一 个 控件 ,常常 与 Gallery 控件 一 起 使 的 显示 界面 
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用 ,可 以 实现 多 张 图 片 进行 切换 的 幻灯 片 效果 。 

ImageSwitcher 获取 图 片 的 常用 方法 如 下 。 

(1) setImageURICUri uri) ,从 URI 地址 获取 图 片 设 置 到 ImageSwitcher 中 。 

(2) setImageResource(Cint resId) ,从 图 片 资源 库 ID 获取 图 片 设置 到 ImageSwitcher 中 。 

(3) setImageDrawable ( Drawable drawable), 从 drawable 目录 中 获取 图 片 设 置 到 
ImageSwitcher 中 。 

下 面 通过 一 个 完整 案例 来 介绍 ImageSwitcher 和 Gallery 的 使 用 方法 。 

【案例 5.12】 使 用 ImageSwitcher 和 Gallery 控件 制作 一 个 浏览 图 片 的 展示 窗 ,这 个 展 
示 窗 分 为 上 下 两 部 分 : 在 屏幕 上 方 展示 当前 选中 的 大 图 片 ; 在 屏幕 的 下 方 是 一 组 可 以 滚动 的 
小 图 片 ,位 于 中 央 位 置 的 小 图 片 即 为 当前 选中 的 图 片 。 

[588] 使 用 ImageSwitcher 作为 大 图 片 的 展示 控件 ,使 用 Gallery 作为 小 图 片 的 滚动 控 
件 。 布 局 文件 可 选用 相对 布局 来 实现 。 

在 ImageSwitcher 的 类 声明 时 要 实现 一 个 ViewSwitcher. ViewFactory 接口 。 这 个 接口 
里 有 一 个 方法 makeViewO ,在 实现 时 需要 定义 它 。 这 个 方法 为 ImageSwitcher 返回 一 个 视图 
View 对 象 。ImageSwitcher 的 调用 过 程 是 : 首先 要 有 一 个 Factory 为 它 提供 一 个 View, 然 后 
ImageSwitcher 就 可 以 初始 化 各 种 资源 了 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_ImageSwitch 的 Android MA. JE 
应 用 程序 名 为 ImageSwitch, 包 名 为 cn. com. sgmsc. imageswitch. Activity 组 件 名 为 
ImageSwitchActivity。 

(2) 准备 图 片 。 将 图 片 资 源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(3) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 image switch. xml, 并 编辑 
之 。 代 码 如 下 所 示 。 

1 <?xml version- "1.0" encoding = "utf - 8"?> 


2 <RelativeLayout 
3 xnlns:android = "http://schemas. android. com/apk/res/android" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent"» 

6 

7 < InageSwitcher 

8 android:id- "(9 * id/switcher" 

9 android:layout width- "fill parent" 

10 android:layout height - "fill parent" 

11 android:layout alignParentTop - "true" 

12 android:layout alignParentLeft - "true" /» 
13 

14 < Gallery android: id= "(9 + id/gallery" 

15 android:background = " # 55000000" 

16 android:layout width- "fill parent" 

Ei] android:layout height - "60dp" 

18 android:layout alignParentBottom = "true" 
19 android:layout alignParentLeft - "true" 
20 android:gravity = "center vertical" 

21 android: spacing = "16dp" 

22 android:unselectedAlpha = "1"/» 
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24 </RelativeLayout > 


(D 第 2 一 24 行 声明 了 一 个 相对 布局 。 
@ 第 7 一 12 行 声明 了 一 个 ImageSwitch 控件 ,与 其 父 控件 的 左 、 上 方 对 齐 , 用 于 显示 选中 


的 大 图 片 。 


© $ 14—22 行 声明 了 一 个 Gallery 控件 ,与 其 父 控件 的 左 、 下 方 对齐 , 用 于 显示 横向 滚动 
的 小 图 标 列表 索引 。 其 中 ,第 15 行 设 置 这 个 Gallery 的 背景 色 为 半 透 明 的 黑色 ,这 样 设置 ,如 
果 大 图 片 的 尺寸 较 大 ,图 片 部 分 与 Gallery 控件 有 重 麦 时 , 半 透 明 的 背景 色 不 会 速 住 大 图 片 的 


显示 。 


(4) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. imageswitch 包 下 的 ImageSwitchActivity. 
java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. imageswitch; 


import android. app. Activity; 

import android. content. Context; 

import android. os. Bundle; 

import android. view. View; 

import android, view. ViewGroup; 

import android. view. Window; 

import android. view. animation. AnimationUtils; 
import android. widget. AdapterView; 

import android. widget. BaseAdapter; 

import android. widget. Gallery; 

import android. widget. ImageSwitcher; 

import android. widget. ImageView; 

import android. widget. ViewSwitcher; 

import android. widget. Gallery. LayoutParams; 


public class ImageSwitchActivity extends Activity implements 
AdapterView.OnItenSelectedListener, ViewSwitcher. ViewFactory ( 


private ImageSwitcher mySwitcher; 
private Integer[] myThnIds = ( 


R.drawable.turing sw, R.drawable.edgar sw, R.drawable.torvalds sw, 
R.drawable.bill sw, R.drawable.andy sw); 


private Integer[] myImgIds = ( 


R. drawable. turing, R. drawable. edgar, R. drawable. torvalds, 
R. drawable. bill, R. drawable. andy}; 


@Override 
public void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 
requestWindowFeature(Window.FEATURE NO TITLE); //i& EX Activity 没有 标题 栏 
setContentView(R.layout. image switch); 


mySwitcher = (ImageSwitcher) findViewById(R. id. switcher); 

mySwitcher. setFactory(this); 

mySwitcher. setInAnimation(AnimationUtils. loadAnimation(this, 
android.R.anim.fade in)); 

mySwitcher. setOutAnimation(AnimationUtils. loadAnimation(this, 
android. R. anim. fade_out) ) ; 
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42 Gallery g = (Gallery) findViewById(R. id. gallery); 

43 g. setAdapter(new ImageAdapter(this)); 

44 g. setOnItemSelectedListener(this); 

45 } 

46 

47 public void onItemSelected(AdapterView<?> parent, View v, int position, long id) { 
48 mySwitcher. setImageResource(myImgIds[position]); ”// 为 mSwitcher 设 选中 的 图 片 资源 
49 } 

50 

51 public void onNothingSelected(AdapterView «?» parent) { 

52 ) 

53 

54 public View makeView() ( 

55 ImageView iv = new ImageView(this); 

56 iv. setBackgroundColor(0xFF000000) ; // 设 置 背景 颜色 

57 iv.setScaleType(ImageView.ScaleType.FIT CENTER); // 

58 iv.setLayoutParams(new ImageSwitcher.LayoutParams(LayoutParams.FILL PARENT, 
59 LayoutParams.FILL PARENT)); 

60 return iv; 

61 ) 

62 

63 // 自 定义 InageAdapter 适配器 

64 public class ImageAdapter extends BaseAdapter { 

65 private Context myContext; 

66 public ImageAdapter(Context c) ( myContext = c; } 

67 public int getCount() ( return myThmIds. length; } 

68 public Object getItem(int position) ( return position; ) 

69 public long getItemId( int position) ( return position; } 

70 public View getView(int position, View convertView, ViewGroup parent) { 
71 ImageView i = new ImageView(myContext); 

72 i.setlmageResource(myThmIds[position]); 

73 i.setAdjustViewBounds(true); 

74 i.setLayoutParams(new Gallery. LayoutParams( 

35 LayoutParams.WRAP CONTENT, LayoutParams. WRAP CONTENT)); 
76 return i; 

77 } 

78 } 

79 

80 } 


(D 6S 18 — 19 行 声 明 ImageSwitchActivity 类 是 一 个 继承 接口 AdapterView. 
OnltemSelectedListener 和 ViewSwitcher. ViewFactory 的 类 。 

© 第 22 一 24 行 声明 一 个 图 片 资源 的 ID 数组 myThmlds, X Gallery 准备 数据 ,第 25 一 27 
行 声明 一 个 图 片 资 源 的 ID 数组 myImgIds ,为 ImageSwitch 准备 数据 。 

@ 第 32 行 设置 这 个 Activity 的 标题 栏 不 可 见 。 注 意 , 如 果 要 设置 窗口 显示 的 属性 ,如 标 
题 栏 不 可 见 ,必须 放 在 “setContentView(…); ”语句 之 前 。 

QD 第 35 一 40 行 设 置 ImageSwitcher 对 象 mySwitcher。 首 先 在 第 35 行 从 资源 中 获取 
ImageSwitcher 的 实例 ; 然后 第 36 行 调用 setFactory() 方 法 ,只 有 在 调用 了 该 方法 后 才能 对 
ImageSwitcher 对 象 进行 其 他 的 操作 ; ImageSwitcher 的 切换 效果 由 第 37、39 行 的 方法 实现 ， 
这 里 的 setInAnimation ( ) 是 资源 被 读 和 人 到 这 个 ImageSwitcher 中 时 实现 的 动画 效果 ， 
setOutAnimation() 是 资源 从 这 个 ImageSwitcher 中 消失 的 时 候 要 实现 的 动画 效果 ,本 例 中 使 
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用 的 动画 效果 是 从 Android. R 系统 文件 中 读 取 的 。 

© 第 54—61 行 定义 了 makeView() 方 法 ,在 其 中 创建 
了 一 个 ImageView 对 象 , 设 置 了 该 对 象 的 一 些 属性 ,并 返回 
给 ImageSwitcher 对 象 mySwitcher。 

© 第 43 行为 Gallery 对 象 g 绑 定 一 个 自 定 义 的 
ImageAdapter 适配器 。 该 适配器 继承 自 BaseAdapter, 在 
第 64 一 78 行 定义 了 这 个 ImageAdapter 适配器 类 ,在 70 一 
77 行 重 写 了 getView( ) 方 法 ,为 滚动 的 图 片 列表 索引 赋予 
资源 数组 myThmlds 的 值 。 

C) 第 44 行为 Gallery 对 象 g 添加 一 个 滚动 监听 
OnItemSelectedListener。 在 第 47 一 49 行为 该 监听 定义 
OnltemSelected() 回 调 方法 ,在 其 中 为 InageSwitcher 对 象 
mySwitcher 获取 选中 图 片 的 资源 ,并 显示 出 来 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 ” 图 5-19 图 片 浏览 切换 展示 窗 
运行 Activity. ImageSwitch 项 目 。 运 行 结果 如 图 5-19 的 效果 
所 示 。 


5.2.3 进度 条 与 滑 块 控件 


前 面 介 绍 了 Android 中 常用 的 各 种 视图 控件 ,本 节 将 对 Android 应 用 中 常用 的 进度 条 和 
拖 动 条 进行 简单 介绍 。 


1. ProgressBar 


ProgressBar 类 位 于 android. widget 包 下 , 它 是 一 个 非常 有 用 的 控件 ,其 最 直观 的 效果 就 
是 进度 条 显示 。 通 常 在 应 用 程序 执行 某 些 较 长 时 间 加 载 资源 或 执行 某 些 耗 时 的 操作 时 ,会 使 
用 到 进度 条 。 

ProgressBar 类 的 使 用 非常 简单 ,只 需要 将 其 显示 在 前 台 , 然 后 启动 一 个 后 台 线 程 定时 更 
新 进度 条 的 进度 progress 数值 即 可 。 


2. SeekBar 


SeekBar 位 于 android. widget 包 下 , 它 继 承 自 ProgressBar, 功能 相似 ,不 同 点 在 于 
SeekBar 是 可 以 被 用 户 拖 动 的 控件 。SeekBar 类 似 于 一 个 尺子 ,可 以 进行 拖拉 滑 块 ,可 以 直观 
地 显示 数据 ,常用 于 调节 声音 大 小 的 应 用 场合 。 


3. RatingBar 


RatingBar 类 位 于 android. widget 包 下 , 它 是 另 一 种 滑 块 .外观 是 5 个 星星 ,可 以 通过 拖 
动 来 改变 进度 。 一 般 用 于 星 级 评分 的 场合 。 

下 面 通过 一 个 完整 案例 来 介绍 进度 条 和 滑 块 条 的 使 用 方法 。 

【案例 5.13】 在 屏幕 中 各 放置 一 个 ProgressBar, SeekBar 和 RatingBar. 当 拖 动 SeekBar 
时 ,另外 两 个 跟着 同步 移动 , 当 拖 动 RatingBar 时 ,另外 两 个 也 同步 移动 。 

【说 明 】 为 ProgressBar 和 SeekBar 设置 进度 刻度 使 用 方法 setProgress(int) ,获得 其 进 


度数 据 使 用 方法 getProgress(); 而 为 RatingBar 设置 星 级 使 用 方法 setRating(float) ,获得 其 
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星 级 使 用 方法 getRating()。 
【开发 步骤 及 解析 】 


CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_ProgressBars 的 Android MA. J 
应 用 程序 名 为 ProgressBars, 包 名 为 cn. com. sgmsc. progressbars, Activity 组 件 名 为 


ProgressBarsActivity。 


(2) 设计 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 progress_bars. xml, 并 编 


辑 之 。 代 码 如 下 所 示 。 


1 


2 <LinearLayout xmlns:android= "http://schemas.android. com/apk/res/android" 


3 


oo-200^5 


10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 


<?xml version = "1.0" encoding = "utf - 8"?» 


android:orientation = "vertical" 
android:layout width- "fill parent" 
android:layout height = "fill parent"» 


< TextView 


android: id= "(à + id/Text01" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:text = "ProgressBar:"/^ 

< ProgressBar 
android: id = "@ + id/ProgressBar01" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:max = "100" 
android:progress = "20" 
style = "(Jandroid:style/Widget. ProgressBar. Horizontal" /» 

< TextView 
android: id = "(9 + id/Text02" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = "SeekBar:"/» 

< SeekBar 
android:id- "(9 + id/SeekBar01" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:max = "100" 
android:progress = "20"/> 

< TextView 
android: id= "(9 + id/Text03" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = "RatingBar:"/» 

« RatingBar 
android:id- "(9 + id/RatingBar01" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:max- "5" 
android:rating- "1" 

/> 


42 </LinearLayout > 


第 17 行 设置 Progress 进度 条 为 条 形 进度 条 。 
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(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. progressbars 包 下 的 ProgressBarsActivity. 


java XAF. H 


voo0o-200mUNqn»^ 


10 


编辑 之 。 代 码 如 下 所 示 。 
package cn. com. sgnsc. progressbars; 


import android. app. Activity; 
import android. os. Bundle; 

import android. widget. ProgressBar; 
import android. widget. RatingBar; 
import android. widget.SeekBar; 


public class ProgressBarsActivity extends Activity ( 
final static double MAX = 100; / [SeekBar ,ProgressBar 的 最 大 值 
final static double MAX_STAR = 5; / /RatingBar 的 最 大 星星 数 


public void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 
setContentView(R. layout.progress bars); 


// 普 通 拖拉 条 被 拉动 的 处 理 代码 
SeekBar sb = (SeekBar)this. findViewById(R. id. SeekBar01) ; 
Sb. setOnSeekBarChangeListener( 
new SeekBar. OnSeekBarChangeListener( ) ( 
public void onProgressChanged(SeekBar seekBar, int progress, 
boolean fromUser) ( 
ProgressBar pb = (ProgressBar)findViewById(R. id. ProgressBar01); 
RatingBar rb = (RatingBar)findViewById(R. id. RatingBar01); 
SeekBar sb = (SeekBar) f indViewById(R. id. SeekBar01); 
pb. setProgress(sb. getProgress()); 
rb.setRating((float)(sb.getProgress()/MAX * MAX STAR)); 
// 将 进度 值 折算 成 星 级 数 
) 
public void onStartTrackingTouch(SeekBar seekBar) ( } 
public void onStopTrackingTouch(SeekBar seekBar) ( } 
) 
) 


RatingBar rb = (RatingBar)findViewById(R. id. RatingBar01); 
rb. setOnRatingBarChangeListener( 
new RatingBar. OnRatingBarChangeListener()( 
(QOverride 
public void onRatingChanged(RatingBar ratingBar, float rating, 
boolean fromUser) ( 
ProgressBar pb = (ProgressBar)findViewById(R. id. ProgressBar01); 
SeekBar sb = (SeekBar) f indViewByld(R. id. SeekBar01) ; 
RatingBar rb = (RatingBar)findViewById(R. id. RatingBar01); 
float rate = rb.getRating(); 
pb.setProgress((int) (rate/MAX STAR x MAX)); 
// 将 0—5 的 星星 数 折算 成 0 一 100 的 进度 值 
sb. setProgress( (int) (rate/MAX STAR * MAX)); 
// 将 0—5 的 星星 数 折算 成 0 一 100 的 进度 值 
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D 58 19—32 ÍTR E SeekBar 的 拖 动 监听 , 当 SeekBar 被 拖拉 时 ,同步 设置 ProgressBar 
和 RatingBar 的 值 。 

© 第 34 一 48 行 设 置 RatingBar 的 拖 动 监听 , 当 RatingBar 被 拖拉 时 ,同步 设置 ProgressBar 
和 SeekBar 的 值 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity ProgressBars 项 目 。 
运行 结果 如 图 5-20 所 示 。 


图 5-20 滑 块 /星星 被 拖拉 时 与 进度 条 的 进度 同步 效果 


5.3 UI 设计 及 应 用 案例 


下 面 通过 一 个 应 用 项 目的 中 心 框架 设计 来 理解 本 章 中 所 介绍 的 内 容 。 

【案例 5.14】 用 选项 卡 的 形式 设计 “掌上 微 博 " 的 中 心 框架 界面 ,通过 这 个 界面 可 以 跳 转 
到 “掌上 微 博 ” 的 任何 可 操作 的 功能 界面 中 。 

【说 明 】 可 以 选用 TabHost 控件 来 设计 这 个 中 心 框架 界面 。 首 先 根据 “掌上 微 博 ” 的 功 
能 模块 分 类 来 定义 选项 页 Tab 的 标题 信息 。 然 后 在 每 一 个 选项 页 中 iei Activity, 

在 Tab 中 显示 Activity. 需要 创建 一 个 Intent 对 象 来 绑 定 个 Activity, 并 使 用 
setContent() 方 法 来 载 人 这 个 Intent 对 象 。 这 样 就 可 以 完成 在 dei Tab 中 显示 另 一 个 
Activity 了 。 

【开发 步骤 及 解析 】 

(1) 功能 设计 。“ 掌 上 微 博 ”的 功能 分 为 快捷 、 好 友 、 日 志和 相册 4 大 模块 ,其 中 在 “快捷 ” 
Tab 中 ,将 “掌上 微 博 ”中 常用 的 功能 用 列表 的 形式 显示 出 来 

(2) Activity 的 界面 设计 。 根 据 * 掌 上 微 博 ?的 功能 可 使 用 TabHost 控件 , 按 “ 快 捷 ”“ 好 
友 ”“ 日 志 ” 和 “相册 ”的 顺序 添加 Tab。 其 中 第 一 个 Tab 就 是 默认 显示 的 界面 。 在 本 例 中 ,只 
详细 设计 这 个 默认 的 界面 , 即 “ 快 捷 ”Activity 的 功能 页 ,其 余 的 Activity 界面 将 在 后 续 章 节 逐 

-补充 。 这 个 “快捷 ”页 的 界面 很 简单 , 它 只 需要 使 用 一 个 ListView 控件 ,将 常用 的 功能 一 一 
列 出 即 可 。 在 此 ,省 略 其 草图 绘制 部 分 。 
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(3) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ZSWB Menu 的 Android 项 目 。 其 应 用 程序 
名 为 ZSWB, 包 名 为 cn. com. sgmsc. ZSWB. Activity 组 件 名 为 FrameTabActivity。 

CD 准备 图 片 。 这 个 项 目 需 要 准备 一 套图 标 ,用 于 在 TabHost 的 标签 中 和 ListView 的 条 
目 中 显示 ,将 制作 的 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(5) 准备 字符 串 资源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version- "1.0" encoding = "utf - 8"?> 


2 <resources> 
3 < string name = "hello"> Hello World, ZSWB!</string> 


4 < string name = "app_name"> 掌 上 微 博 </string> 

5 < string name = "ZSWB"> 掌 上 微 博 </string> 

6 

7 < string name = "PublishActivity"> 掌 上 微 博 —— 快速 发 布 </string> 
8 < string name = "ContactsActivity"> 掌 上 微 博 -- 最 近 访客 </string> 
9 < string name = "MyDiaryActivity"> 掌 上 微 博 -- 我 的 日 志 </string> 
10 < string name = "AlbunListActivity"»3K k (18 —— 相册 列表 </string> 
11 < string name = "btnBack"> 返 回 </string> 

12 < string name = "tabtitlel"> 快 捷 </string> 

13 < string name = "tabtitle2"> 好 友 </string> 

14 < string name = "tabtitle3"> 日 志 </string> 

15 < string name = "tabtitle4"> 相 册 </string> 

16 


17 «/resources » 


(6) 创建 数组 资源 。 创 建 并 编写 res/values 目录 下 的 数组 描述 文件 arrays. xml, 代 码 如 
下 所 示 。 


1 <?xml version = "1.0" encoding= "utf - 8"?> 
2 <resources> 

3 < string- array name = "lvtexts"> 

4 < item> 写 书 日 志 </item> 

5 < item > 拍照 上 传 </item > 

6 «/string- array» 

7 < string- array name = "lvicons"» 
8 < iten» p diary«/iten» 


9 < item» p camera </item> 
10 «/string- array» 
11 


12 «/resources > 


(7) 创建 颜色 资源 。 创 建 并 编写 res/values 目录 下 的 颜色 描述 文件 colors. xml, 参 见 本 
书 源 代码 , 源 代 码 可 从 指定 网 站 中 下 载 ,在 此 不 作 北 述 。 

(8) 创建 样式 资源 。 创 建 并 编写 res/values 目录 下 的 样式 描述 文件 style. xml, 参 见 本 书 
源 代码 。 

(9) 设计 初始 进入 的 Activity 布局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 
normal. xml, 并 编辑 之 。 代 码 如 下 所 示 。 

1 <?xml version = "1.0" encoding = "utf 一 8"?> 

2 <LinearLayout 

3  xnlns:android- "http: //schemas. android. con/apk/res/android" 

4 

5 


android:orientation = "vertical" 
android:background = "(à drawable/back" 
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6  android:layout width- "fill parent" 

7  android:layout height- "fill parent" 

8 » 

9  «ListView 

10 android:id- "(9 + id/lvPublish" 

11 android:divider = "@color/listDivider" 
12 android:dividerHeight = "2px" 

13 android:layout width- "fill parent" 

14 android:layout height = "fill parent" 
15 人 > 


16 </LinearLayout > 


第 11 一 12 行为 ListView 控件 的 分 隔 线 设置 颜色 和 线 的 高 度 。 

(10) 设计 其 他 Activity 布局 。 创 建 并 编写 res/layout 目录 下 的 其 他 布局 文件 contacts. 
xml, diary_ list. xml, album, list. xml。 本 例 不 详细 开发 这 三 个 文件 的 布局 ,只 是 分 别 在 
diary list. xml, album list. xml 文件 中 添加 一 个 Button 而 已 ,下 面 是 diary list. xml 文件 的 
代码 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 <RelativeLayout 

3 xmlns:android= "http: //schenas. android. con/apk/res/android" 
4  android:orientation = "vertical" 

5  android:paddingLeft = "8px" 

6 — android:background = "(2 drawable/back" 

7  android:layout width- "fill parent" 

8  android:layout height- "fill parent" 

9 


> 
10 «ScrollView 

11 android:fillViewport = "true" 

12 android:layout width- "fill parent" 

13 android:layout height = "fill parent" 

14 android:layout alignParentTop - "true" 

15 android:layout alignParentLeft - "true" 

16 > 

17 X TextView 

18 android:id- "(à + id/txtv" 

19 android:layout width- "fill parent" 
20 android:layout height - "fill parent" 
21 android:textColor = "(color/character" 
22 android:text =" 日 志 页 面 建设 中 .…" 
23 android:textSize = "20dip" 

24 /> 

25 «/ScrollView» 

26 «Button 

21 android:id- "@ + id/Dia btnBack" 

28 style = "(Qstyle/button" 

29 android:layout width- "120px" 

30 android:layout height = "wrap content" 

31 android:layout alignParentBottom = "true" 
32 android:layout alignParentRight - "true" 

33 android:layout marginRight = "5px" 

34 android: text = "@ string/btnBack" 

35 f> 


36 </RelativeLayout > 
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(11) 


开发 项 目的 第 一 个 Activity. 1] Jf src/cn. com. sgmsc. ZSWB 包 下 的 


FrameTabActivity. java 文件 ,并 编辑 之 。 这 个 文件 是 对 本 项 目的 TabHost 控件 进行 逻辑 代 
码 设计 ,可 以 认为 是 本 应 用 项 目的 中 心 框架 部 分 ,代码 如 下 所 示 。 


package cn. com. sgnsc. ZSWB; 


import android. app. TabActivity; 
import android. content. Intent; 


import android. view. Window; 
import android. widget. TabHost; 


i 
2 
3 
4 
5 import android. os. Bundle; 
6 
7 
8 
9 


public class FrameTabActivity extends TabActivity( 
10 (ZOverride 
11 protected void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 


requestWindowFeature(Window.FEATURE NO TITLE); ”// 设 置 这 个 Activity 没有 标题 栏 
final TabHost tabHost - getTabHost(); 

Intent itNormal = new Intent(this, NormalActivity.class); 

Intent itContact = new Intent(this, ContactsActivity.class); 

Intent itDiary = new Intent(this, DiaryListActivity.class); 

Intent itAlbum = new Intent(this, AlbumListActivity. class); 


tabHost. addTab( tabHost. newTabSpec("tab1" ) 
. setIndicator(getResources().getText(R. string. tabtitlel), 
getResources() . getDrawable(R. drawable. publish)) 
. setContent( itNormal) 
); 
tabHost. addTab(tabHost. newTabSpec( " tab2" ) 
. setIndicator(getResources().getText(R. string. tabtitle2), 
getResources().getDrawable(R. drawable. friend)) 
. setContent( itContact) 
) 
tabHost. addTab(tabHost. newTabSpec( " tab3" ) 
. setIndicator(getResources().getText(R. string. tabtitle3), 
getResources() . getDrawable(R. drawable. diary) ) 
. setContent( itDiary) 
) 
tabHost. addTab(tabHost. newTabSpec(" tab4" ) 
. setIndicator(getResources().getText(R. string. tabtitle4), 
getResources(). getDrawable(R. drawable. album) ) 
. setContent( itAlbum) 
) 


O 第 13 行 设置 窗口 的 标题 栏 不 显示 。 使 用 此 设置 需要 引入 android. view. Window 包 。 

© 58 15—18 行 声明 4 个 Intent 对 象 ,分 别 绑 定 4 个 Activity。 

@ 从 第 20 行 起 逐一 向 TabHost 对 象 tabHost 中 添加 选项 卡 。 其 中 第 20 一 24 行 是 添加 
名 为 "tabl? 的 选项 卡 ,在 setIndicator 中 使 用 getResources(). getText(R. string. tabtitlel ) 设 
置 Tab 的 标题 文本 ,使 用 getResources(). getDrawable(R. drawable. publish) 设 置 Tab 的 标 
题 图 标 ; 使 用 setContent 设置 该 选项 卡 显示 的 内 容 , 这 里 指定 的 是 itNormal(Intent 对 象 ) , 即 
显示 NormalActivity 的 界面 。 
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(12) 开发 TabHost 中 第 一 个 Tab 对 应 的 Activity。 创 建 并 编写 src/cn. com. sgmsc. 
ZSWB 包 下 的 NormalActivity. java 文件 ,该 文件 是 TabHost 中 第 一 个 Tab 所 对 应 的 
Activity, 完 成 本 项 目 中 对 快捷 功能 模块 的 逻辑 实现 。 代 码 如 下 所 示 。 
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package cn. com. 


import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 


sgnsc. ZSWB; 


app. Activity; 

content. Intent; 

os. Bundle; 

view.Gravity; 

view. View; 

view. ViewGroup; 

view. ViewGroup. LayoutParams; 
widget. AdapterView; 

widget. AdapterView. OnItemClickListener; 
widget.BaseAdapter; 

widget. ImageView; 

widget. LinearLayout; 

widget. ListView; 

widget. TextView; 


public class NormalActivity extends Activity( 


(QOverride 


protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
setContentView(R. layout. normal); // 设 置 当前 屏幕 
ListView lvPublish = (ListView)findViewById(R. id. lvPublish); // 获 得 ListView 对 象 引 用 


BaseAdapter ba = new BaseAdapter() ( 


// 取 得 ListView 的 item 项 文本 内 容 的 数组 
String[] items = getResources().getStringArray(R. array. lvtexts); 


// 取 得 ListView 的 item 项 图 标 资源 的 数组 
String[] imgIds = getResources().getStringArray(R. array. lvicons); 


(QOverride 


public 


View getView(int position, View convertView, ViewGroup parent) { 
LinearLayout ll = new LinearLayout(NormalActivity. this); 
11.setOrientation(LinearLayout. HORIZONTAL) ; 
11.setGravity(Gravity. CENTER) ; 
ImageView iv = new ImageView(NormalActivity. this); 

// 创 建 ImageView 对 象 
iv.setAdjustViewBounds(true); 


iv. setInageDrawable(getResources().getDrawable( 

getResources() . getIdentifier(imgIds[position], "drawable", 

getPackageNane() ) ) ) ; 
11. addView(iv); // 将 InageView 添加 到 线性 布局 中 
TextView tv = new TextView(NormalActivity. this); 
tv. setPadding(10, 0, 0, 0); 
tv. setLayoutParams(new LinearLayout 

.LayoutParams(LayoutParams. WRAP CONTENT, LayoutParams. WRAP CONTENT)); 

tv.setTextAppearance(NormalActivity.this, R. style. title); 
tv. setText( items[ position] ); // 设 置 TextView 显示 的 内 容 
11. addView(tv); 
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50 return ll; 

51 } 

52 @Override 

53 public long getItemId( int position) ( 

54 return 0; 

55 } 

56 (QOverride 

57 public Object getItem(int position) ( 

58 return null; 

59 ) 

60 (QOverride 

61 public int getCount() ( 

62 return items. length; 

63 ) 

64 h 

65 

66 lvPublish. setAdapter(ba); 

67 

68 lvPublish. setOnItemClickListener(new OnItemClickListener() ( 

69 (GQOverride 

70 public void onItemClick(AdapterView <?> parent, View v, int position, 
71 long id) { 

72 switch(position)( // 判 断 选 择 的 是 哪 一 个 选项 
73 case 0: // 书 写 日 志 

74 Intent intentDia = new Intent(); 

75 intentDia. setClass(NormalActivity.this, DiaryListActivity.class); 
76 startActivity(intentDia); 

7l break; 

78 case 1: // 拍 照 上 传 

79 Intent intentAlb = new Intent(); 

80 intentAlb. setClass(NormalActivity.this, AlbumListActivity.class); 
81 startActivity(intentAlb); 

82 break; 

83 } 

84 } 

85 ni 

86 } 

87 } 


(D 第 28 行 和 第 30 行 从 数组 描述 文件 中 取得 ListView 的 item 项 显示 的 文本 和 图 标 数据 。 

© 第 32—51 行 重 写 BaseAdapter 的 getView() 方 法 ,定义 ListView 对 象 lvPublish 每 一 
个 item 的 显示 及 内 容 。 

© 585 68—86 行为 lvPublish 对 象 添加 OnItemClickListener 监听 , 当 单 击 了 lvPublish 中 
的 条 目 时 ,会 跳 转 到 相应 的 Activity 中 去 。 

(13) 开发 其 余 的 Activity。 创 建 并 编写 src/cn. com. sgmsc. ZSWB 包 下 的 ContactsActivity. 
java, DiaryListActivity. java 和 AlbumListActivity. java 文件 。 本 例 不 详细 开发 这 三 个 代码 文 
件 , 只 是 分 别 对 DiaryListActivity. java 和 AlbumListActivity. java 文件 中 的 Button 监听 进行 
了 简单 的 事件 回调 处 理 而 已 ,在 此 以 DiaryListActivity. java 文件 为 例 , 给 出 其 代码 如 下 所 示 。 


package cn. com. sgmsc. ZSWB; 


import android. app. Activity; 
import android. content. Intent; 


AODNDP 
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5 import android.os.Bundle; 

6 import android. view. View; 

7 import android. view. View.OnClickListener; 
8 import android.widget.Button; 

9 


10 public class DiaryListActivity extends Activity{ 
11 @Override 
12 protected void onCreate(Bundle savedInstanceState) { 


13 super. onCreate(savedInstanceState); 

14 setContentView(R. layout.diary list); // 设 置 当 前 屏幕 
15 

16 Button btnback - (Button) findViewById(R. id.Dia btnBack); 

17 OnClickListener btnlsn = new OnClickListener()( 

18 (QOverride 

19 public void onClick(View v) ( 

20 Intent intentback = new Intent(); 

21 intentback. setClass(DiaryListActivity.this, FrameTabActivity.class); 
22 startActivity(intentback); 

23 finish(); 

24 ) 

25 h 

26 btnback. setOnClickListener(btnlsn); 

27.) 

28 

29 } 


CD 第 19 一 24 行 定义 onClick() 回 调 方法 , 当 单 击 了 按钮 时 ,会 跳 转 回 FrameTabActivity 中 。 

© 第 23 行 的 finish() 方 法 是 用 来 关闭 DiaryListActivity。 注 意 , 当 调用 finish() 方 法 时 ， 
只 是 将 Activity 推 向 后 台 , 并 没有 立即 释放 内 存 , Activity 的 资源 并 没有 被 清理 ; 而 当 调 用 
System. exit(0) 时 ,是 真正 杀 死 整个 进程 ,这 时 候 Activity 所 占 的 资源 也 随 之 被 释放 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 KDWB_Menu 项 目 。 初 始 运 
行 效果 如 图 5-21 所 示 。 选 择 * 日 志 ? 选 项 卡 后 如 图 5-22 所 示 , 这 时 单 击 * 返 回 ” 按 钮 ,可 以 回 到 
初始 界面 。 在 初始 界面 中 单 击 “ 书 写 日 志 ” 项 进入 写 日 志 页 ,如 图 5-23 所 示 。 


& wi d 0930 


掌上 微 博 -我 的 日 志 


图 5-21 初始 运行 时 的 界面 效果 图 5-22 选择 日志 ?选项 卡 图 5-23 在 初始 界面 单 击 “ 书 写 
后 的 界面 日 志 ” 后 的 界面 
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小 结 


本 章 较 详 细 地 介绍 了 Android 事件 的 处 理 机 制 , 包 括 几 种 常用 的 回调 事件 和 基于 监听 接 
口 的 事件 处 理 。 接 下 来 ,重点 介绍 了 与 适配器 相关 的 控件 AutoCompleteTextView Spinner, 
List View,GridView 和 Gallery, 还 简单 地 介绍 了 其 他 视图 控件 和 进度 条 与 滑 块 控件 。 对 于 所 
介绍 的 控件 都 给 出 了 完整 案例 ,从 多 个 角度 说 明了 常见 适配器 的 构建 方法 和 常用 监听 接口 的 
添加 与 回调 方法 的 编程 。 

本 章 的 案例 较 多 ,并 且 都 有 一 定 的 深度 。 相 信 读 者 在 学 习 之 后 能 较 好 地 掌握 Android 的 
控件 应 用 编程 。 这 些 控件 以 及 第 4 章 中 介绍 的 控件 都 是 Android 应 用 程序 中 经 常用 到 的 屏幕 
元 素 , 熟 练 地 掌握 它们 的 使 用 方法 是 必 不 可 少 的 技能 。 当 然 , 在 实际 开发 中 只 运用 这 些 控件 是 
不 够 的 ,还 有 一 些 控件 如 菜单 、 对 话 框 ,也 是 应 用 程序 经 常 使 用 的 屏幕 元 素 ,将 在 第 6 章 中 
介绍 。 


练习 


1. 使 用 ScrollView 控件 ,将 第 4 章 、 第 5 童 的 控件 使 用 案例 组 合 到 一 个 应 用 项 目 中 ,要 求 
在 屏幕 中 垂直 放置 多 个 按钮 , 单 击 每 个 按钮 ,对 应 调用 一 个 案例 的 Activity。 

提示 一 下 ， 

COD ScrollView 控件 内 只 能 包含 一 个 控件 ,可 以 在 项 目的 main. xml 布局 文件 中 如 下 
设计 。 

<?xml version = "1.0" encoding = "utf - 8"?> 

< ScrollView …> 

< LinearLayout …> 
< Button = /> 


< Button- /> 
< Button. /> 


e Button-- /> 
</LinearLayout …> 

</ScrollView …> 

(2) 其 他 的 布局 文件 和 Java 代码 文件 可 以 从 相应 的 案例 中 复制 过 来 ,同时 别 忘记 有 些 案 
例 中 还 包括 相关 资源 如 图 片 资源 、 数 组 资源 strings. xml, colors. xml 等 ,都 要 一 并 复制 过 来 。 

(3) 这 个 项 目 中 有 多 个 Activity, 一 定 要 在 AndroidManifest. xml 中 声明 之 。 

2. 在 第 4 章 完成 的 微 博 登录 界面 和 注册 界面 设计 的 基础 上 ,增加 如 下 功能 : 单 击 登录 界 
面 中 的 “注册 ”按钮 ,可 跳 转 到 注册 界面 中 , 单 击 注册 界面 中 的 “返回 ”按钮 ,可 返回 到 登录 界面 。 


菜单 与 对 话 框 


在 实际 的 应 用 开发 中 经 常 要 用 到 菜单 和 对 话 框 。 在 应 用 程序 中 添加 一 些 菜单 ,或 在 用 户 
执行 了 某 些 操作 后 给 出 一 些 对 话 框 回馈 信息 ,可 以 让 用 户 体验 更 完善 ,让 程序 功能 更 完备 。 


菜单 (Menu) 的 设计 在 人 机 交互 中 可 以 说 是 非常 人 性 化 的 , 它 提供 了 不 同 功能 分 组 展示 的 能 
力 。Android 平台 提供 三 种 类 型 的 菜单 : 选项 菜单 (OptionMenu) ,上 下 文 菜单 (ContextMenu) 
和 子 菜单 (SubMenu) 。 


6.1.1 选项 菜单 


当 用 户 单 击 手机 设备 上 的 Menu 按键 时 ,弹出 的 菜单 就 
是 选项 菜单 (OptionMenu)。 选 项 菜单 的 菜单 项 最 多 只 能 有 6 
个 ,每 个 菜单 项 可 以 携带 图 标 。 当 菜单 项 超过 6 个 时 ,第 6 个 自 
动 显 示 “ 更 多 ”选项 来 展示 显示 , 且 这 个 菜单 项 将 不 会 显示 图 标 。 
Android 系统 自 带 有 选项 菜单 ,在 其 模拟 器 中 , 当 单 击 Menu f£ 
键 时 ,将 会 在 屏幕 底部 弹出 如 图 6-1 所 示 的 选项 菜单 。 

OptionMenu 在 android. view. Menu 包 中 定义 ,一 个 选项 
菜单 是 一 个 Menu 对 象 , Menu 对 象 中 可 以 添加 菜单 项 
Menultem。 选 项 菜单 的 功能 需要 开发 人 员 编程 来 实现 ,如 果 
在 开发 应 用 程序 中 没有 实现 选项 菜单 功能 ,那么 程序 运行 时 
按 下 手机 上 的 Menu 键 是 不 会 起 作用 的 。 在 Android 中 通过 
回调 方法 创建 菜单 并 处 理 菜单 按 下 的 事件 。 选 项 菜单 常用 的 ”图 6-1 Android 模拟 器 自 带 的 


回调 方法 如 表 6-1 所 示 。 选项 菜单 
表 6-1 选项 菜单 中 常用 的 回调 方法 及 说 明 
5 È 描 x 
onCreateOptionsMenu( Menu) 初始 化 选项 菜单 ,只 在 首次 显示 菜单 时 调用 
onOptionsItemSelected( Menultem) 当 其 中 某 个 菜单 项 被 选中 时 调用 ,默认 返回 false 
onOptionsMenuClosed( Menu) 当选 项 菜单 关闭 或 按 下 返回 键 .或 选择 了 某 菜单 项 时 调用 


onPrepareOptionsMenu(Menu) 为 程序 准备 选项 菜单 ,每 次 选项 菜单 显示 前 调用 
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Menu 类 对 象 是 一 个 菜单 , 它 包含 一 个 或 多 个 菜单 项 Menultem, 也 可 以 包含 子 菜 单 
SubMenu。Menu 中 常用 的 方法 如 表 6-2 所 示 。 


5 È 


R 6-2 Menu 中 常用 的 方法 及 说 明 


$9 HU 


Add(int groupld, int itemld. 
int order. CharSequence title) 


Add(Cint groupld, int itemId, 
int order, int titleRes) 


Add(CharSequence title) 


Add(int titleRes) 


groupld; 菜单 项 所 在 的 组 Id, 通 过 分 
组 可 以 对 菜单 项 进行 批量 操作 ,如 果 
菜单 项 不 属于 任何 组 ,传人 NONE; 
itemld; 菜单 项 的 ID; 

order; 菜单 项 的 顺序 

title: 菜单 项 显示 的 文本 对 象 ; 
titleRes: 菜单 项 显示 文本 的 资源 符 


向 Menu 中 添加 一 个 菜单 项 , 返 
回 一 个 Menultem 对 象 


finditemCint Id) 


Id 是 Menultem 对 象 的 标识 符 


返回 指定 Id 的 Menultem 对 象 


size) 


返回 Menu 中 菜单 项 的 个 数 


Menultem 对 象 代表 一 个 菜单 的 菜单 项 , 当 用 户 选 择 菜单 项 时 需要 一 些 回调 方法 给 予 响 
应 。 常 用 的 回调 方法 如 表 6-3 所 示 。 
表 6-3 Menultem 中 常用 的 方法 及 说 明 


5 È 9$ Hx 
setAlphabeticShortcut(char alphaChar) |alphaChar: 字母 快捷 键 设置 Menultem 的 字母 快捷 键 
setNumericShortcut(char numericChar) | numericCh: 数字 快捷 键 设置 Menultem 的 数字 快捷 键 
setIcon( Drawable icon) Icon: 图 标 对 象 设置 Menultem 的 图 标 
Intent; 5; Menultem 绑 定 | 为 Menultem 绑 定 Intent 对 象 , 当 被 

的 Intent 对 象 选中 时 将 调用 startActivity 方法 


setOnMenultemClickListener 


(Menultem, OnMenultemClickListener 


menultemClickListener) 


[3 


menultemClickListener : 


LE 


为 Menultem 设置 监听 器 ,回调 方法 
一 般 采 用 onOptionsItemSelected() 


setShortcut( char numericChar, char 


alphaChar) 


numericChar: 数字 快捷 键 
alphaChar: 字母 快捷 键 


设置 Menultem 的 数字 快捷 键 和 字 
母 快捷 键 


setTitleCint titleRes) 


titleRes: 标题 文本 的 资源 符 


setTitle(CharSequence title) 


title: 标题 文本 对 象 


设置 Menultem 的 标题 


设计 一 个 选项 菜单 时 要 为 用 户 提供 交互 接口 ,以 响应 菜单 项 被 单 击 的 事件 。 创 建 选项 菜 


单 需要 如 下 步骤 。 


(1) 第 一 步 , 重 写 Activity 的 onCreateOptionsMenu(Menu menu) 方 法 , 当 第 一 次 打开 菜 


单 时 该 方法 被 自动 调用 。 


(2) 第 二 步 ,调用 Menu 的 add() 方 法 添加 菜单 项 Menultem, 此 时 ,可 以 调用 Menultem 
的 setIcon() 方 法 来 为 菜单 项 设置 图 标 。 
(3) 第 三 步 , 定 义 菜单 项 被 选择 之 后 的 回调 事件 。 有 两 种 方法 : 其 一 , 重 写 Activity 的 
onOptionsltemSelected() 方 法 , 当 菜 单项 Menultem 被 选择 时 ,该 方法 用 于 响应 事件 ; 其 二 ,为 
每 个 菜单 项 Menultem 对 象 添加 OnMenultemClickListener 监听 器 ,在 其 中 定义 处 理 菜单 选 


项 中 的 事件 。 


下 面 通过 一 个 简单 案例 来 说 明 选 项 菜单 的 使 用 方法 。 


Som 菜单 与 对 话 框 


【案例 6.1】 设置 选项 菜单 ,其 中 有 两 个 菜单 项 :“ 开 始 " 和 “返回 "。 当 接收 用 户 在 菜单 中 


的 选项 后 ,在 屏幕 的 文本 框 控 件 中 显示 选择 的 内 容 。 


[88] 在 本 例 中 ,使 用 为 菜单 项 Menultem 对 象 添加 OnMenultemClickListener 监听 


器 的 方式 处 理 选择 事件 。 


【开发 步骤 及 解析 】 
COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity_OptionMenu 的 Android 项 目 。 其 应 用 程 


序 名 为 OptionMenu, 包 名 为 cn. com. sgmsc. optionmenu, Activity 组 件 名 为 OptionMenuActivity。 


Java 


(2) 准备 图 片 。 将 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 
(3) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 
1 <?xml version = "1.0" encoding = "utf - 8"?> 


2 «LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
3 android:layout_width = "fill_parent" 


4 android:layout_height = "fill_parent" 

5 android:orientation = "vertical" > 

6 

7 < TextView 

8 android:id- "(à + id/tv01" 

9 android:layout width- "fill parent" 
10 android:layout height = "wrap content" 
11 android: textSize = "26px" 

12 android: text = "请 选择 .…." /> 

13 


14 </LinearLayout > 


COD 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. optionmenu 包 下 的 OptionMenuActivity. 
文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgnsc. optionmenu; 


1 
2 
3 import android. app. Activity; 

4 import android. os. Bundle; 

5 import android. widget. TextView; 

6 import android. view. Menu; 

7 import android. view. MenuItem; 

8 import android. view. MenuItem. OnMenuItemClickListener; 
9 


10 public class OptionMenuActivity extends Activity { 


11 

12 private TextView text; 

13 // 菜 单项 D H 

14 private static final int ITEM1 = Menu. FIRST; 

15 private static final int ITEM2 = Menu. FIRST * 1; 
16 

37 @Override 

18 public void onCreate(Bundle savedInstanceState) { 
19 super. onCreate(savedInstanceState); 

20 setContentView(R. layout. main); 

21 

22 text = (TextView) findViewById(R. id. tv01); 
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24 

25 // 添 加 菜单 项 

26 public boolean onCreateOptionsMenu(Menu menu) ( 

27 // 添 加 两 个 菜单 项 

28 

29 Menultem begmenuitem = menu.add(0, ITEM1, 0, "开始 "); 
30 begnenuitem. setIcon(R.drawable.ic enter); 

31 MenuItem retmenuitem = menu.add(0, ITEM2, 0, "返回 "); 
32 retmenuitem. setIcon(R.drawable.ic return); 

33 

34 OnMenuItemClickListener lsn = new OnMenuItemClickListener()( 
35 // 响 应 菜单 选项 被 单 击 事件 

36 @Override 

37 public boolean onMenultemClick(MenuItem item)( 
38 switch (item.getItemId()) ( 

39 // 

40 case ITEM: 

4l text. setText(" 你 选择 了 : 开始 。"); 

42 break; 

43 case ITEM2: 

44 text. setText(" 你 选择 了 : 返回 。"); 

45 break; 

46 } 

47 return true; 

48 } 

49 h 

50 

51 begnenuitem. setOnMenuItemClickListener(lsn); 

52 retmenuitem. setOnMenuItemClickListener(lsn); 

53 return true; 

54 ) 

55 

56 ) 


O 58 14—15 行 定义 菜单 项 ID 常量 ,用 于 稍 后 设置 菜单 项 使 用 。 

© 第 26 一 49 行 定 义 了 onCreateOptionsMenu () 方 法 ,在 其 中 为 菜单 添加 了 两 个 菜单 项 ， 
第 29 行 添加 了 菜单 项 begmenuitem, 其 ID 号 为 常量 ITEMI1 ,其 显示 的 文本 为 “开始 ”, 第 30 
行为 此 菜单 项 设置 了 图 标 ; 同样 ,第 31 一 32 行 添加 了 另 一 个 菜单 项 。 

© 在 onCreateOptionsMenu() 方 法 内 还 创建 了 OnMenultemClickListener 监听 对 象 lsn, 
并 定义 了 回调 方法 onMenultemClick()。 其 中 使 用 switch 语句 定义 : 当选 择 菜 单 ID 为 
ITEMI 时 ,屏幕 的 Text View 控件 显示 “你 选择 了 : 开始 。.”, 当 选择 菜单 ID 为 ITEM2 时 , 屏 
幕 的 TextView 控件 显示 “你 选择 了 : 返回 。” 

@ 58 51,52 行为 两 个 菜单 项 添加 OnMenultemClickListener 监听 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity_OptionMenu 项 目 。 
初始 运行 时 , 当 按 下 手机 (或 模拟 器 ) 中 的 menu 键 时 ,屏幕 显示 如 图 6-2 所 示 , 当 按 下 了 “ 开 
始 " 菜 单项 时 ,屏幕 显示 如 图 6-3 所 示 , 放 开 按 下 的 菜单 项 , 则 屏幕 显示 如 图 6-4 所 示 。 


Som 菜单 与 对 话 框 


& wi B 06:47 


a] 
请 选择 .… 


图 6-2 按 下 手机 的 menu 键 ， 图 6-3 按 下 “开始 ”菜单 项 的 图 6-4 释放 “开始 "菜单 项 的 


6.1.2 fX 


了 菜单 (SubMenu) 类 位 于 android. view & F , 它 继承 自 Menu, 每 个 SubMenu 对 象 代表 
-个 子 菜单 。 子 菜单 就 是 将 相同 功能 的 菜单 项 分 组 进行 多 级 显示 的 一 种 菜单 ,例如 , Word 窗 
口中 的 “文件 ”菜单 中 有 “新建 >“ 打开“ 关闭 ”等 子 菜单 
SubMenu 通常 与 选项 菜单 联合 使 用 , 往 菜单 中 添加 子 菜单 与 添加 菜单 项 的 方法 差不多 ， 
只 是 方法 名 不 一 样 ,使 用 addSubMenu() 方 法 ,但 其 参数 与 add() 方 法 中 的 参 - 样 。 
SubMenu 中 常用 的 方法 如 表 6-4 所 示 


表 6-4 SubMenu 中 常用 的 方法 及 说 明 


方 法 参 数 描 述 
setHeaderIcon(Drawable icon) icon: 图 标 对 象 y " - Es 
setHeaderIcon(int id) id: 图 标 资源 ID SETA NACER 
setHeaderTitle(CharSequence title) | title: 文本 对 象 " " 可 
set HeaderTitleCint id) id: 文本 资源 ID 和 

设置 指定 的 View 对 T 
setHeader View View view) view: 标题 的 View 对 象 全 帮主 全 Vie AUR TE EAR 
单 的 图 标 
setIcon(Drawable icon) icon: 图 标 对 象 设置 子 菜单 在 父 菜 单 中 显示 的 
setIcon(int id) id: 图 标 资源 ID 图 标 


下 面 通过 一 个 案例 来 说 明 选 项 菜单 与 子 菜单 的 用 法 。 

【案例 6.2】 设置 选项 菜单 .其 中 有 两 个 分 别 是 :“ 性 别 ? 子 菜单 “爱好 ? 子 菜单 。 当 
接收 用 户 选 择 了 子 菜单 中 的 菜单 项 时 ， io us 

【说 明 】 在 本 例 中 ,“ 性 别 " 子 菜单 选用 单 选 子 菜单 方式 构建 ,“ 爱 好 ” 子 菜 单 选 WT 
单方 式 构建 。 处 理 菜 单项 被 选择 的 和 响应 事件 ,采用 重 1 写 Activity 的 cuni 
Jk. 
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【开发 步骤 及 解析 】 


(1) a 


EMH. Æ Eclipse 中 创建 一 个 名 为 Activity Menu 的 Android 项 目 。 其 应 用 程序 名 


为 “Menu and SubMenu”, 包 名 为 cn. com. sgmsc. Menu. Activity 组 件 名 为 MenuActivity。 
(2) 准备 图 片 。 将 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 
(3) 准备 字符 串 资源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 
2 «resources» 

< string name = "hello"» Hello World, MenuActivity!</string> 
< string name = "app name"» Menu and SubMenu «/string? 


15 


< string name = "label"> 您 的 选择 为 : Nn «/string» 


< string name = "gender"> 性 别 </string> 
< string name = "male"> 男 </string> 

< string name = "female"> 女 </string> 

< string name = "hobby"> 爱 好 </string> 
< string name = "hobby0"> 运 动 </string> 
< string name = "hobbyl"> 唱 歌 </string> 
< string name = "hobby2"> 旅 游 </string> 
< string name = "hobby3"> 游 戏 </string> 
< string name = "hobby4"> 冒 险 </string> 
< string name = "hobby5"> 摄 影 </string> 


16 </resources > 


(4) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf 一 8"?> 
2 <LinearLayout 


20 
21 


android: id= "(9 + id/LinearLayout01" 
android: background = "@drawable/bg02" 
android: layout_width = "fill parent" 
android: layout_height = "fill_parent" 
android:orientation = "vertical" 


xmlns:android = "http://schemas. android. com/apk/res/android"><! -- 声明 一 个 线性 


布局 --> 
< ScrollView 
android: id= "(9 + id/ScrollView01" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
< EditText 
android:id- "(9 + id/EditText01" 


android:layout width- "fill parent" 
android:layout height = "fill parent" 


android:editable - "false" 
android:cursorVisible = "false" 
android: text = "(9 string/label"» 
</EditText > 
</ScrollView> 


22 </LinearLayout > 


考虑 到 将 在 这 个 EditText 控件 中 不 断 添 加 文本 内 容 , 可 能 会 超过 屏幕 的 显示 范围 ,所 以 
将 这 个 EditText 控件 放 在 ScrollView 控件 中 。 
(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Menu 包 下 的 MenuActivity. java 文件 ,并 
编辑 之 。 代 码 如 下 所 示 。 


<! -- 声明 一 个 ScrollView 控件 --> 


<! -- 声明 一 个 EditText 控件 --> 


package cn. com. sgns. Menu; 


import android. app. Activity; 
import android. os. Bundle; 
import android. view. Menu; 
import android. view. MenuItem; 
import android. view. SubMenu; 
import android. widget. EditText; 


public class MenuActivity extends Activity { 
final int MENU GENDER MALE = 0; 
final int MENU GENDER FEMALE = 1; 
final int MENU HOBBYO - 2; 
final int MENU HOBBY1 = 3; 
final int MENU HOBBY2 - 4; 
final int MENU HOBBY3 - 5; 
final int MENU HOBBY4 - 6; 
final int MENU HOBBYS = 7; 
final int MENU GENDER - 8; 
final int MENU HOBBY - 9; 
final int GENDER GROUP - 0; 
final int HOBBY GROUP = 1; 
final int MAIN GROUP - 2; 


Menultem[ ] myHobby = new MenuItem[6]; 
MenuItem male = null; 


(2 Override 


Som 菜单 与 对 话 框 


// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 


// 性 别 为 男 选项 编号 

// 性 别 为 女 选项 编号 
// 爱 好 1 选项 编号 

// 爱 好 2 选项 编号 

// 爱 好 3 选项 编号 

// 爱 好 4 选项 编号 

// 爱 好 5 选项 编号 

// 爱 好 6 选项 编号 

/A* 性 别 ” 子 菜单 编号 

//“ 爱 好 ” 子 菜单 编号 

/A* 性 别 " 子 菜单 项 组 的 编号 
//“ 爱 好 ” 子 菜单 项 组 的 编号 
/外 层 总 菜单 项 组 的 编号 


/A/* 爱 好 ”菜单 项 组 
// 男 性 性 别 菜单 项 


public void onCreate(Bundle savedInstanceState) {// 重 写 onCreate() 方 法 


super. onCreate(savedInstanceState); 
setContentView(R. layout. main); 


) 


@Override 
public boolean onCreateOptionsMenu(Menu menu) { 


// 设 置 当前 屏幕 


// 性 别 ? 单 选 菜单 项 组 ”菜单 若 编组 就 是 单 选 菜单 项 组 
SubMenu subMenuGender = menu. addSubMenu(MAIN_GROUP, MENU_GENDER, 0, R. string.gender); 


subMenuGender. setIcon(R. drawable. gender); 


subMenuGender. setHeaderIcon(R. drawable. gender); 


male = subMenuGender.add(GENDER GROUP, MENU GENDER MALE, 0, R. string. male); 


male. setChecked(true); 


subMenuGender. add(GENDER GROUP, MENU GENDER FEMALE, 0, R. string. female); 


// 设 置 GENDER. GROUP 组 是 可 选择 的 , 互 斥 的 


subMenuGender. setGroupCheckable(GENDER GROUP, true, true); 


//“ 爱 好 ” 复 选 菜单 项 组 


SubMenu subMenuHobby = menu.addSubMenu(MAIN GROUP,MENU_ HOBBY, 0, R. string. hobby) ; 


subMenuHobby. setIcon(R. drawable. hobby) ; 
subMenuHobby. setHeaderIcon(R. drawable. hobby) ; 


myHobby[0] = subMenuHobby.add(HOBBY GROUP, MENU HOBBYO, 0 
myHobby[1] = subMenuHobby. add(HOBBY GROUP, MENU HOBBY, 0, 
myHobby[2] = subMenuHobby.add(HOBBY GROUP, MENU HOBBY2, 0 
myHobby[3] = subMenuHobby.add(HOBBY GROUP, MENU HOBBY3, 0 
myHobby[4] = subMenuHobby. add(HOBBY GROUP, MENU HOBBY4, 0, 
myHobby[5] = subMenuHobby.add(HOBBY GROUP, MENU HOBBYS, 0, 


R. string. hobby0) ; 
R. string. hobby1) ; 
R. string. hobby2) ; 
, R. string. hobby3) ; 
R. string. hobby4) ; 
R. string. hobby5) ; 


myHobby[0]. setCheckable(true); // 设 置 菜单 项 为 复 选 菜单 项 


myHobby[1]. setCheckable(true); 
myHobby[2]. setCheckable(true); 
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myHobby[3]. setCheckable(true); 
myHobby[4]. setCheckable(true); 
myHobby[5]. setCheckable(true); 


return true; 


) 


@Override // 单 选 或 复 选 菜单 项 选中 状态 变化 后 的 回调 方法 
public boolean onOptionsItemSelected(MenuItem mi){ 
switch(mi.getItemId())( 
case MENU GENDER MALE: // 单 选 菜 单项 状态 的 切换 要 自行 写 代码 完成 
case MENU GENDER FEMALE: 
mi. setChecked(true); 


appendStateStr() ; // 当 有 效 项 目 变化 时 记录 在 文本 区 中 
break; 
case MENU HOBBYO: // 复 选 菜 单项 状态 的 切换 要 自行 写 代 码 完成 


case MENU_HOBBY1 : 
case MENU HOBBY2: 
case MENU HOBBY3: 
case MENU HOBBYA4: 
case MENU HOBBY5: 
ni. setChecked(! mi. isChecked() ) ; 
appendStateStr(); // 当 有 效 项 目 变化 时 记录 在 文本 区 中 
break; 
} 
return true; 


} 


// 获 取 当 前 选择 状态 的 方法 
public void appendStateStr()( 
String mychoice = "您 选择 的 性 别 为 : "; 
if(male. isChecked()){ 
mychoice = mychoice + "5j"; 
} 
else{ 
mychoice = mychoice + "Ar"; 
) 
// 获 取 被 选中 的 所 有 爱好 
String hobbyStr = ""; 
for(MenuItem mi:myHobby) ( 
if(mi. isChecked())( 
hobbyStr = hobbyStr + ni.getTitle() * ","; 
) 
} 
if(hobbyStr.length()» 0){ 
mychoice = mychoice + ", 您 的 爱好 为 : " + hobbyStr. substring(0, hobbyStr. length() 
= 
} 
else( 
mychoice = mychoice +", Wn"; 

} 

EditText et = (EditText)MenuActivity. this. findViewById(R. id. EditText01); 

et. append(mychoice); 
} 


O 55 11—12 行 定义 “性 别 ? 子 菜单 项 的 ID 常量 ; 第 13 一 18 行 定义 “爱好 ? 子 菜单 项 的 ID 
常量 ; 第 19,20 行 定 义 两 个 子 菜单 本 身 的 ID 常量 ; 第 21、22 行 定义 两 个 子 菜 单 的 分 组 ID 常 
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量 ; 第 23 行 定义 最 外 层 总 菜单 组 的 ID 常量 。 

© 58 25 行 声明 了 一 个 Menultem 数组 myHobby, 用 于 存储 爱好 菜单 项 组 。 第 26 行 声 明 
了 一 个 菜单 项 变量 male, 用 于 判断 性 别 , 如 果 male 为 选中 状态 ,表示 是 “ 男 ” 性 ,否则 为 
“ 女 ” 性 。 

© 第 35 一 64 行 定义 了 菜单 创建 方法 onCreateOptionsMenu(Menu menu)。 其 中 ,第 36 一 44 
行 是 为 性别? 单 选 菜单 创建 实例 ,第 37 一 39 行 是 定义 “性 别 ” 子 菜单 subMenuGender, 第 40 
行为 子 菜单 添加 一 个 菜单 项 , 且 赋 予 菜 单项 变量 male 中 ,第 41 行 设置 该 菜单 项 为 选中 状态 ， 
即 设置 单 选 菜单 的 默认 选项 ,第 44 行 设置 GENDER. GROUP 组 是 可 选择 的 , 互 斥 的 , 即 设置 
了 该 子 菜 单 为 单 选 菜单 ; 第 47 一 61 行 是 为 “爱好 ” 复 选 菜单 创建 实例 ,第 47 一 49 行 是 定义 “ 爱 
好 ? 子 菜单 subMenuHobby, 第 50 一 55 行为 "爱好 ? 子 菜单 添加 6 个 菜单 项 ,上 且 赋予 菜单 项 数组 
myHobby 中 ,第 56 一 61 行 是 设置 菜单 项 为 可 选 的 , 即 设置 了 该 子 菜单 为 复 选 菜单 ; 第 63 行 
执行 返回 定义 好 的 菜单 实例 ,完成 onCreateOptionsMenu(Menu menu) 方 法 。 

(D 第 67 一 85 行 定义 了 onOptionsItemSelected() 方 法 。 在 该 方法 内 ,使 用 switch-case if 
句 ,分 别 对 每 一 个 子 菜单 项 执行 操作 ,第 69 一 73 行 , 对 于 选中 的 菜单 项 执行 自 定 义 方 法 
appendStateStr() ,第 74 一 82 行 ,对 于 与 原 选择 状态 不 同 的 菜单 项 ( 即 选择 状态 发 生 了 改变 的 
菜单 项 的 ) 执 行 自 定义 方法 appendStateStrO 。 

© 第 88 一 111 行 定 义 appendStateStr() 方 法 。 第 90 一 95 行 ,判断 male 的 值 为 true 时 , 表 
示 是 “ 男 ” 性 ,否则 为 “ 女 " 性 ; 第 97 一 102 行 ,对 myHobby 数组 中 的 每 一 元 素 逐 一 进行 检查 ,对 
于 处 于 被 选中 状态 的 项 ,将 其 菜单 项 文本 内 容 拼接 到 字符 串 变 量 hobbyStr 中 ; 第 103 一 108 
行将 字符 串 变量 hobbyStr 中 的 内 容 拼 接 到 字符 串 变量 mychoice 中 ; 第 109—110 行将 字符 串 
变量 mychoice 中 的 内 容 设置 到 EditText 控件 et 对 象 中 ,并 显示 出 来 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity Menu 项 目 。 初 始 运 
行 时 , 当 按 下 手机 (或 模拟 器 ) 中 的 menu 键 时 ,屏幕 显示 如 图 6-5 所 示 , 当 按 下 了 “性 别 " 菜 单 
项 后 屏幕 显示 如 图 6-6 所 示 ,选择 了 菜单 项 后 屏幕 显示 如 图 6-7 所 示 , 当 按 下 了 “爱好 ”菜单 项 
后 屏幕 显示 如 图 6-8 所 示 ,选择 了 菜单 项 后 屏幕 显示 如 图 6-9 所 示 。 这 里 , 复 选 菜单 项 一 次 只 
能 选择 一 次 ,如果 要 选择 多 项 就 需要 按 多 次 menu fi, 


Menu and subMenu 


您 的 选择 为 ; 


Menu and subMenu 


图 6-5 按 下 手机 的 menu 键 ， 图 6-6 HTF EI RAK 图 6-7 选择 “性 别 ” 菜 单项 后 
显示 选项 菜单 显示 效果 的 显示 效果 
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Menu and SubMenu 


THERA : 
选择 的 性 别 为 : 男 。 
您 选择 的 性 别 为 : 男 ,您 的 爱好 为 : 旅 


游 
您 选择 的 性 别 为 : 男 ,您 的 爱好 为 : 唱 
Bh NOR. 


图 6-8 按 下 “爱好 ”菜单 的 显示 效果 图 6-9 选择 “爱好 ?中 两 项 后 的 显示 效果 


6.1.3 上 下 文 菜单 


当 用 户 长 时 间 按 键 不 放 时 ,弹出 的 菜单 称 为 上 下 文 菜单 (ContextMenu)。 人 们 经 常 在 手 
机 的 文本 编辑 框 设置 输入 法 时 会 使 用 上 下 文 菜单 ContentMenu。 

ContentMenu 位 于 android. view 包 下 , 它 继承 自 Menu。 当 ContentMenu 注册 于 某 个 
View 对 象 上 后 ,长 按 下 该 View 对 象 时 ,系统 会 弹出 上 下 文 菜单 。ContentMenu 的 菜单 项 不 
支持 快捷 键 ,不 附带 图 标 ,但 是 ContentMenu 的 标题 可 以 指定 图 标 。ContentMenu 中 常用 的 
方法 如 表 6-5 所 示 。 


表 6-5 ContentMenu 中 常用 的 方法 及 说 明 


5 È 2 "Uu 描 g 


menu; 创建 的 上 下 文 菜单 每 次 为 View 对 象 呼出 上 
vi 上 下 文 菜单 依附 的 View 对 象 下 文 菜单 时 都 调用 
menulnfo: 上 下 文 菜单 需要 额外 显示 


onCreateContextMenu(ContextMenu menu, 


View v, ContextMenu. ContextMenulInfo 


menulnfo) 的 信息 

onContextItemSelected( Menultem,item) item; 被 选中 的 上 下 文 菜单 选项 当 用 户 选择 了 上 下 文 菜 
单 选项 后 调用 

onContextMenuClosed( Menu menu) menu: 被 关闭 的 上 下 文 菜单 当 上 下 文 菜单 被 关闭 时 
调用 

registerForContextMenu( View view) view: 要 显示 上 下 文 菜单 的 View 对 象 为 指定 的 View 对 象 注册 
一 个 上 下 文 菜单 


在 程序 中 创建 一 个 上 下 文 菜单 需要 如 下 步骤 。 

CD 第 一 步 , 重 写 Activity 的 onCreateContextMenu() 方 法 ,调用 Menu 的 add() 方 法 添 
加 菜单 项 Menultem, 

(2) 第 二 步 , 重 写 Activity 的 onContextItemSelected() 方 法 , 啊 应 菜单 单 击 事件 。 

(3) 第 三 步 , 调 用 registerForContextMenu() 方 法 .为 视图 View 对 象 注 册 上 下 文 菜单 。 
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使 用 registerForContextMenu() 方 法 为 View 对 象 注册 上 下 文 菜单 用 法 很 简单 ,例如 ,要 
为 一 个 资源 ID 名 为 “et01” 的 EditText 控件 注册 上 下 文 菜单 ,那么 在 类 的 onCreate() 方 法 中 
EX: 

this. registerForContextMenu(findViewById(R. id. et01)); 


为 View 对 象 注册 了 上 下 文 菜单 后 ,Android 系统 会 自动 地 为 指定 的 View 对 象 添 加 一 个 
View. OnCreateContextMenuListener 监听 器 。 这 样 , 当 长 按 该 View 时 就 会 弹出 上 下 文 
菜单 。 


6.2 对 话 框 


对 话 框 (Dialog) 是 Activity 运行 时 弹出 的 小 窗口 。 例 如 , 当 用 户 要 删除 一 个 联系 人 时 ,会 
弹出 一 个 对 话 框 ,让 用 户 确 认 是 否 真 地 要 删除 。 当 显示 对 话 框 时 ,当前 的 Activity 失去 焦点 进 
入 可 见 状态 ,而 由 对 话 框 负责 所 有 的 人 机 交互 。 使 用 对 话 框 的 主要 目的 是 提示 消息 ,或 弹出 一 
个 与 程序 主 进程 直接 相关 的 小 程序 。 


6.2.1 对 话 框 简介 


Android 系统 主要 提供 4 类 对 话 框 : 提示 对 话 框 (AlertDialog)、 对 话 框 进度 (ProgressDialog)、 
日 期 选择 对 话 框 (DatePickerDialog) 和 时 间 选 择 对 话 框 (TimePickerDialog)。 它 们 都 位 于 
android. app 包 下 。 


1. 常见 的 对 话 框 


1) AlertDialog 

AlertDialog 类 定义 在 android. app. AlertDialog 类 中 , 它 可 以 包含 一 些 文本 、 单 选 按钮 或 
复 选 框 以 及 0 一 4 个 一 般 的 按钮 ,是 最 常用 的 对 话 框 ,能 够 满足 常见 的 对 话 框 用 户 界面 的 需求 。 
提示 对 话 框 AlertDialog 可 以 进一步 地 细 分 为 普通 对 话 框 , 列 表 对 话 框 . 单 选 按钮 对 话 框 和 复 
选 对 话 框 。 

2) ProgressDialog 

ProgressDialog 继承 自 AlertDialog ,可 以 显示 进度 条 或 者 进度 轮 ,并 且 在 对 话 框 中 可 以 添 
加 按钮 。 

3) DatePickerDialog 

DatePickerDialog 对 话 框 可 以 显示 并 人 允许 用 户 修改 日 期 。 

4) TimePickerDialog 

TimePickerDialog 对 话 框 可 以 显示 并 允许 用 户 修改 时 间 。 


2. 对 话 框 的 创建 与 使 用 


对 话 框 是 作为 Activity 的 一 部 分 被 创建 和 显示 的 ,在 程序 中 通过 重 写 一 些 回调 方法 来 创 
建 , 保 存 、 回 复 对 话 框 。 如 果 需 要 自 定义 对 话 框 的 外 观 等 样式 ,可 以 继承 Dialog 或 其 子 类 并 定 
义 自己 的 布局 。Dialog 常用 的 方法 如 表 6-6 所 示 。 
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表 6-6 Dialog 常用 的 方法 及 说 明 


方 法 参 数 描 述 
onCreateDialog(int id) id: 代表 该 对 话 框 的 ID 创建 对 话 框 ,只 在 首次 显示 对 话 框 时 调用 
showDialog(int id) id: 同上 显示 指定 ID 的 对 话 框 
onPrepareDialog(int id, Dialog) menu: 被 关闭 的 上 下 文 菜单 ” 每 次 显示 对 话 框 前 调用 
dismissDialog(int id) id: 代表 该 对 话 框 的 ID 关闭 指定 ID 的 对 话 框 
removeDialog(int id) id: 代表 该 对 话 框 的 ID 关闭 指定 ID 的 对 话 框 并 彻底 释放 之 


Android 系统 通过 onCreateDialog() 回 调 方法 来 完成 对 话 框 的 创建 , 当 创建 好 对 话 框 后 ， 
在 Activity 的 最 后 返回 这 个 对 象 。 注 意 ,该 方法 只 在 对 话 框 第 一 次 被 显示 时 执行 ,用 于 创建 一 
个 对 话 框 实例 ,之 后 将 不 再 重复 创建 该 实例 。 

当 要 显示 一 个 对 话 框 时 ,调用 showDialog() 方 法 并 传递 一 个 唯一 标识 这 个 对 话 框 的 整数 
ID。 如 果 在 Activity 中 重 写 了 onPrepareDialogO 77 3 ,那么 系统 在 调用 showDialog() 方 法 之 
前 会 自动 调用 onPrepareDialog() 方 法 。 在 onPrepareDialog() 方 法 内 可 以 对 指定 的 对 话 框 属 
性 作 设置 ,如 果 不 重 写 该 方法 ,那么 每 次 显示 的 对 话 框 将 会 是 最 初创 建 的 那个 。 

当 准 备 关 闭 对 话 框 时 ,可 以 对 Activity 调用 dismissDialog() 方 法 ,或 可 以 通过 对 该 对 话 杠 
调用 dismiss() 来 消除 它 。 注 意 , 用 这 种 方式 关闭 的 对 话 框 不 会 彻底 消失 ,在 Android 的 后 台 
会 保留 其 状态 ,如 果 需 要 彻底 清除 对 话 框 ,需要 调用 removeDialog() 方 法 ,将 删除 任何 内 部 对 
象 对 其 的 引用 而 且 如 果 这 个 对 话 框 正在 显示 , 它 将 被 消除 。 


6.2.2 对话 框 案例 


【案例 6.3】 在 一 个 Activity 里 ,通过 一 组 按钮 ,分别 打 开 几 种 常见 的 对 话 框 。 

【说 明 】 在 本 例 中 ,所 有 按钮 ,对话 框 中 显示 的 文字 全 部 来 自 strings. xml 和 array. xml 
资源 文件 。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Activity Dialog 的 Android 项 目 。 其 应 用 程 
序 名 为 Dialogs, 包 名 为 cn. com. sgmsc. dialog. Activity 组 件 名 为 DialogActivity。 

(2) 准备 图 片 。 将 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(3) 准备 字符 串 资源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 

2 «resources» 

3 < string name = "hello"» Hello World, DialogActivity!«/string» 

4 < string name = "app name"» Dialogs </string > 

5 «string name = "btn1"> 显 示 普 通 对 话 框 </string> <! -- 声明 名 为 btn 的 字符 串 资源 --> 
6 «string name = "titlel"> 普 通 对 话 框 </string> «!-- 声明 名 为 title 的 字符 串 资源 --> 
7 < string name = "dialog msgl"> 这 是 普通 对 话 框 中 的 内 容 !!!</string> 

8 < string name = "btn2"> 显 示 列 表 对 话 框 </string> 

9 < string name = "title2"> 列 表 对 话 框 </string> 

10 < string name = "dialog_msg2"> 在 列表 中 ,你 喜欢 哪 种 运动 ?</string> 

11 < string name = "btn3"> 显 示 单 选 按钮 对 话 框 </string> 

12 < string name = "title3"> 单 选 按钮 对 话 框 </string> 
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13 < string name = "dialog_msg3"> 单 选 ,你 喜欢 哪 种 运动 ?</string> 
14 < string name = "btn4"> 显 示 复 选 框 对 话 框 </string> 

15 < string name = "title4"> 复 选 框 对 话 框 </string> 

16 < string name = "dialog msg4"> 可 多 选 ,你 喜欢 哪 种 运动 ?</string> 
17 < string name = "btnok"> 显 示 进 度 对 话 框 </string> 

18 < string name = "titleok"> 完 成 进度 </string> 

19 < string name = "dialog msgok"> 请 稍 等 ...</string> 

20 < string name = "date"> 显 示 日 期 选择 对 话 框 </string> 

21 < string name = "titledt"> 日 期 选择 对 话 框 </string> 


22 < string name = "dialog msgdt"> 这 是 日 期 选择 对 话 框 中 的 内 容 !!4</string> 
23 < string name = "time"> 显 示 时 间 选 择 对 话 框 </string> 


24 < string name = "titletm"> 时 间 选 择 对 话 框 </string> 

25 < string name = "dialog msgtm"> 这 是 时 间 选 择 对 话 框 中 的 内 容 !!4</string> 
26 

27 < string name = "ok"> 确 定 </string> 

28 < string name = "cancel"> 取 消 </string> 


29 </resources > 


(4) 创建 数组 资源 。 创 建 并 编写 res/values 目录 下 的 数组 描述 文件 array. xml, 代 码 如 下 
所 示 。 


1 <?xml version="1.0" encoding = "utf - 8"?> 

2 <resources> 

3 < string - array name = "msa"> <! -- 声明 一 个 字符 串 数组 --> 

4 < itenm > 游泳 </item> <! -- 向 数组 中 加 入 元 素 -> 
5 < iten > 快走 </item> <! -- 向 数组 中 加 入 元 素 --» 
6 < item > 跑步 </item> <! -- 向 数组 中 加 入 元 素 --> 
7 «/string- array» 

8 «/resources» 


(5) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 o 


1 <?xml version - "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:paddingLeft - "20dip" 

" android:paddingRight - "20dip" 

6 android:background = "(2 drawable/bg" 

7 android:layout_width = "fill_parent" 

8 android:layout_height = "fill_parent" 

9 android:gravity = "center_horizontal" 

10 > <! -- 声明 一 个 线性 布局 --> 
1 

12 «EditText 

13 android:text = "" 

14 android:id- "(8 + id/EditText0l" 

15 android:layout width- "fill parent" 

16 android:layout height = "wrap content" 

17 android:editable = "false" 

18 android:cursorVisible = "false" 

19 /> <! -- 声明 一 个 EditText 控件 --> 
20 < Button 

21 android: text = "@string/btn1" 

22 android: id= "(9 + id/Button01" 

23 android: layout_width = "180dip" 


24 android:layout_height = "wrap_content" 
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25 /> <! -- 声明 一 个 Buttonl 控件 --> 
26 < Button 

27 android: text = "(8string/btn2" 

28 android:id- "(2 + id/Button02" 

29 android:layout width = "180dip" 

30 android:layout height = "wrap content" 

31 /> <! -- 声明 一 个 Button2 控件 --> 
32 < Button 

33 android: text = "@string/btn3" 

34 android: id= "@ + id/Button03" 

35 android:layout width = "180dip" 

36 android:layout height = "wrap content" 

37 /> <! -- 声明 一 个 Button3 控件 --> 
38 <Button 

39 android:text = "@string/btn4" 

40 android: id= "(9 + id/Button04" 

4l android:layout width = "180dip" 

42 android:layout height = "wrap content" 

43 人 > <! -- 声明 一 个 Button4 控件 --> 
44 < Button 

45 android: text = "(3string/date" 

46 android: id= "@ + id/Buttondt" 

47 android:layout_width = "180dip" 

48 android:layout height = "wrap content" 

49 /> <! -- 声明 一 个 Buttondt 控件 --> 
50 <Button 

51 android: text = "(à string/time" 

52 android: id= "(9 + id/Buttontm" 

53 android:layout width- "180dip" 

54 android:layout height = "wrap content" 

55 /> <! -- 声明 一 个 Buttontn 控件 -- 
56 «Button 

57 android: text = "@ string/btnok" 

58 android: id= "(9 + id/Buttonok" 

59 android:layout width- "180dip" 

60 android:layout height = "wrap content" 

61 /> <! -- 声明 一 个 Buttonok 控件 --> 
62 


63 </LinearLayout > 

从 第 20 一 61 行 声明 了 7 个 按钮 ,每 个 按钮 调用 一 个 对 话 框 。 

(6) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. dialog 包 下 的 DialogActivity. java 文件 ,并 
编辑 之 。 代 码 如 下 所 示 。 


1 package cn. com. sgmsc. dialog; // 声 明 包 语 句 
2 

3 import java.util.Calendar; // 引 入 相关 类 
4 

5 import android. app. Activity; // 引 入 相关 类 
6 import android.app.AlertDialog; // 引 入 相关 类 
7 import android. app. Dialog; // 引 入 相关 类 
8 import android.app.AlertDialog.Builder; // 引 入 相关 类 
9 import android. app. ProgressDialog; // 引 入 相关 类 
10 import android. app. DatePickerDialog; // 引 入 相关 类 


11 import android. app. TimePickerDialog; // 引 入 相关 类 


12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 


47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 


import android. content. DialogInterface; 
import android. content. DialogInterface. OnClickListener; 


import android. os.Handler; 

import android. os. Message; 

import android. os. Bundle; 

import android. view. View; 

import android. widget. Button; 
import android. widget. EditText; 
import android. widget. DatePicker; 
import android. widget. TimePicker; 


public class DialogActivity extends Activity { 


final int COMMON DIALOG - 1; 

final int LIST DIALOG = 2; 

final int LIST DIALOG SINGLE - 3; 
final int LIST DIALOG MULTIPLE = 4; 


boolean[] mulFlags = new boolean[](true, false, true}; 


String[] items = null; 


final int PROGRESS DIALOG- 5; 
final int INCREASE = 6; 
ProgressDialog pd; 

Handler myHandler; 


final int DATE DIALOG - 6; 
final int TIME DIALOG = 7; 
Calendar c = null; 


@Override 


Som 菜单 与 对 话 框 


// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 
// 引 入 相关 类 


// 普 通 对 话 框 id 

// 声 明 列表 对 话 框 的 id 

// 记 录 单 选 列表 对 话 框 的 id 

// 记 录 复 选 按钮 对 话 框 的 id 

// 初 始 复 选 情况 
// 选 项 数组 


// 声 明 进 度 对 话 框 id 
//Handler 消息 类 型 


//Handler 对 象 引用 
// 日 期 选择 对 话 框 id 


// 时 间 选 择 对 话 框 id 
// 声 明 一 个 日 历 对 象 


public void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 
setContentView(R. layout. main); 


// 打 开 普通 对 话 框 的 按钮 


Button btnl = (Button) this. findViewById(R. id. Button01); 


// 设 置 当前 屏幕 


// 获 得 btnl 对 象 


btnl.setOnClickListener(new View. OnClickListener()( 


@Override 


public void onClick(View v) { 
showDialog(COMMON DIALOG); 


) 


// 为 btnl 设置 OnClickListener 监听 器 


// 重 写 onClick() 方 法 
// 显 示 普通 对 话 框 


-— // 这 里 省 略 了 若干 个 打开 对 话 框 按钮 的 代码 段 , 这些 代码 与 第 45 一 51 行 相似 


// 打 开 进 度 对 话 框 的 按钮 


Button bok = (Button)this. findViewById(R. id. Buttonok); 


bok. setOnClickListener( 


new View. OnClickListener(){ 


@Override 


public void onClick(View v) { 
showDialog(PROGRESS DIALOG); 


) 
} 
); 
myHandler = new Handler(){ 


// 获 得 bok 对 象 
// 设 置 OnClickListener 监听 器 
// 重 写 onClick() 方 法 
// 显 示 进 度 对 话 框 


// 创 建 Handler 对 象 
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82 @Override 


GOverride 
public void handleMessage(Message msg) ( 


switch(msg. what) { 

case INCREASE: 
pd.incrementProgressBy(1); ”// 进 度 每 次 加 1 
if(pd. getProgress()>= 100)( // 判 断 是 否 结束 进度 
pd. dismiss();  // 如 果 进 度 条 走 完 则 关闭 窗口 
} 
break; 
} 
super. handleMessage( msg); 


83 protected Dialog onCreateDialog(int id) { // 重 写 onCreateDialog() 方 法 


100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 ] 


// 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 


@Override 
public void onPrepareDialog(int id, Dialog dialog){ 


// 每 次 弹出 对 话 框 时 更 新 对 话 框 内 容 的 方法 


super. onPrepareDialog(id, dialog); 
switch(id)( 


case PROGRESS DIALOG: 
pd. incrementProgressBy( - pd. getProgress() );// 对 话 框 进度 清 零 
new Thread()( // 创 建 一 个 线程 
public void run(){ 
while(true){ 
myHandler.sendEmptyMessage(INCREASE); // 发 送 Handler 消息 
if(pd.getProgress()» - 100)( 
break; 
) 
try{ 
Thread. sleep( 40); // 线 程 休眠 
) 
catch(Exception e)( 
e. printStackTrace() ; // 捕 获 并 打印 异常 


).start(); // 启 动 线程 


(D 58 24—38 行 声 明了 7 个 对 话 框 的 ID 常量 和 与 对 话 框 相关 的 数组 ,需要 引用 的 对 象 。 

© 第 45~~51 行 获取 按钮 对 象 btn1, 并 添加 按钮 监听 ,在 监听 中 重 写 onClick() 方 法 。 第 
49 行使 用 方法 showDialog(COMMON_DIALOG) 显 示 普 通 的 对 话 框 。 紧 跟 后 面 的 若干 行 代 
码 均 类 似 于 第 45 一 51 行 的 代码 段 .在 此 省 略 了 ,完整 代码 参见 本 书 指定 网 址 上 的 源 代码 。 
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第 56 一 64 行 是 定义 按钮 bok 和 添加 监听 , 当 单 击 此 按钮 时 显示 进度 对 话 框 。 

(D 第 65 一 78 行 创建 一 个 Handler 对 象 。 当 进度 对 话 框 显示 时 ,定义 进度 条 的 前 进 速度 ; 
第 72 行 定义 当 进 度 条 走 完 时 退出 对 话 框 。 

© 第 88 一 111 行 重 写 了 onPrepareDialog( ) 方 法 ,主要 是 对 进度 对 话 框 的 进度 进行 清 零 处 
理 。 其 中 创建 了 一 个 线程 ,定义 每 隔 0. 04s 更 新 一 次 进度 。 这 段 代 码 涉及 线程 方法 的 知识 ,将 
在 第 8 章 作 详细 介绍 。 

这 部 分 省 略 的 代码 是 重 写 onCreateDialog ( ) 方 法 ,用 于 定义 各 类 对 话 框 。 其 中 使 用 
switch-case 语句 分 别 对 每 个 对 话 框 进行 定义 。 具 体 代码 解析 如 下 。 


1  (ZOverride 
2 protected Dialog onCreateDialog(int id) { //3& 5 onCreateDialog()J7j ik 
3 Dialog dialog = null; // 声 明 一 个 Dialog 对 象 用 于 返回 
4 Builder b = new AlertDialog. Builder(this); 
5 suitch(id)( // 对 过 进行 判断 
6 case COMMON DIALOG: 
7 b. setIcon(R.drawable. ic header); // 设 置 对 话 框 的 图 标 
8 b. setTitle(R. string. btn1); // 设 置 对 话 框 的 标题 
9 b.setMessage(R.string.dialog msgi); ”// 设 置 对 话 框 的 显示 内 容 
10 b. setPositiveButton( // 添 加 按钮 
11 R. string. ok, 
12 new OnClickListener() { // 为 按钮 添加 监听 器 
13 @Override 
14 public void onClick(DialogInterface dialog, int which) { 
15 EditText et = (EditText)findViewById(R. id. EditText01); 
16 et. setText (R. string.dialog nsgl);//iX f EditText 内 容 
17 } 
18 D; 
19 dialog = b.create(); // 生 成 Dialog 对 象 
20 break; 
21 case LIST DIALOG: 
22 b. setIcon(R.drawable. ic header); 1/474 35 73 
23 b. setTitle(R. string.title2); // 设 置 标题 
24 b. setItems( // 设 置 列表 中 的 各 个 属性 
25 R.array.msa, // 字 符 串 数 组 
26 new DialogInterface. OnClickListener() { 
// 为 列表 设置 OnClickListener 监听 器 
27 GOverride 
28 public void onClick(DialogInterface dialog, int which) ( 
29 EditText et = (EditText)findViewById(R. id. EditText01); 
30 et. setText(" 您 选择 了 : " 
31 + getResources() . getStringhrray(R. array. msa) [which] ) ; 
32 } 
33 Di 
34 dialog- b.create(); // 生 成 Dialog 对 象 
35 break; 
36 case LIST DIALOG SINGLE: 
37 b. setIcon(R. drawable. ic header); // 设 置 图 标 
38 b. setTitle(R. string.title3); // 设 置 标题 
39 b. setSingleChoiceItems( // 设 置 单 选 列 表 选 项 


40 R.array.msa, 
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41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 


67 
68 
69 
70 
71 
72 
73 
74 
75 


76 
7i 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 


0, 
new DialogInterface. OnClickListener() { 
(2 Override 
public void onClick(DialogInterface dialog, int which) { 
EditText et = (EditText)findViewById(R. id. EditText01); 
et. setText(" 您 选择 了 : " 
+ getResources() . getStringArray(R. array. msa) [ which]) ; 
} 
D 
b. setPositiveButton( // 添 加 一 个 按钮 
R. string.ok, // 按 钮 显示 的 文本 
new DialogInterface. OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) {} 
H; 
dialog = b.create(); // 生 成 Dialog 对 象 
break; 
case LIST DIALOG MULTIPLE: 
b. setIcon(R. drawable. ic header); // 设 置 图 标 


b. setTitle(R. string. title4); // 设 置 标题 
b. setMultiChoiceItems( // 设 置 复 选 选项 
R.array.msa, 
mulFlags, // 传 人 初始 的 选中 状态 
new DialogInterface. OnMultiChoiceClickListener() ( 
@Override 
public void onClick(DialogInterface dialog, int which, boolean 
isChecked) { 
mulFlags[which] = isChecked; // 设 置 选中 标志 位 


String result = "您 选择 了 : "; 
for(int i= 0;i«mulFlags. length; i++ )( 
if(mulFlags[i])( // 如 果 该 选项 被 选中 


result = result + items[i]-*","; 


) 
EditText et = (EditText)findViewById(R. id. EditText01); 
et.setText(result. substring(0, result. length() - 1)); 


// 设 置 EditText 显示 的 内 容 
) 
ni 
b. setPositiveButton( // 添 加 按钮 
R.string.ok, 
new DialogInterface. OnClickListener()( 
(GOverride 


public void onClick(DialogInterface dialog, int which) () 
Di 


dialog - b.create(); // 生 成 Dialog Jj1k 
break; 
case DATE DIALOG: // 生 成 日 期 对 话 框 的 代码 
c = Calendar. getInstance(); // 获 取 日 期 对 象 
dialog = new DatePickerDialog( // 创 建 DatePickerDialog 对 象 
this, 


new DatePickerDialog.OnDateSetListener()( // 创 建 0nDateSetListener 监听 器 
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91 @Override 

92 public void onDateSet(DatePicker dp, int year, int month, int dayOfMonth) ( 

93 EditText et = (EditText)findViewById(R. id. EditText01); 

94 month = month + 1; 

95 et.setText(" fiti ff f : " + year + "4E" + nonth + "月 " + dayOfMonth + " H"); 

96 ) 

97 ) 

98 c.get(Calendar. YEAR), // 传 入 年 份 

99 c.get(Calendar.MONTH), // 传 人 月 份 

100 c.get(Calendar.DAY OF MONTH) // 传 人 天 数 

101 

102 ); 

103 break; 

104 case TIME_DIALOG: // 生 成 时 间 对 话 框 的 代码 

105 c = Calendar. getInstance(); // 获 取 日 期 对 象 

106 dialog = new TimePickerDialog( // 创 建 TimePickerDialog 对 象 

107 this, 

108 new TimePickerDialog. OnTimeSetListener(){ // 创 建 0nTimeSetListener 监听 器 

109 @Override 

110 public void onTimeSet(TimePicker tp, int hourOfDay, int minute) { 

111 EditText et = (EditText)findViewById(R. id. EditText01); 

112 et. setText(" 您 选择 了 : " + hourOfDay + "时 " + minute + "分 "); 
// 设 置 EditText 控件 属性 

113 } 

114 b 

115 c.get(Calendar.HOUR OF DAY), // 传 人 当前 小 时 数 

116 c. get(Calendar.MINUTE), // 传 人 当前 分 钟 数 

113 false 

118 by 

119 break; 

120 case PROGRESS DIALOG: // 创 建 进度 对 话 框 

121 pd = new ProgressDialog(this); // 创 建 进度 对 话 框 

122 pd. setMax(100); // 设 置 最 大 值 

123 // pd. setProgressStyle(ProgressDialog. STYLE SPINNER); // 环 形 进度 条 

124 pd. setProgressStyle(ProgressDialog. STYLE HORIZONTAL); // 水 平 进度 条 

125 pd. setTitle(R. string.titleok); // 设 置 标题 

126 pd. setMessage( "请 稍 等 …"); 

127 pd. setCancelable(false); // 设 置 进 度 对 话 框 不 能 用 “ 回 退 ”按钮 关闭 

128 dialog = pd; 

129 break; 

130 default: 

131 break; 

132 ) 

133 return dialog; // 返 回 生成 Dialog 的 对 象 

134 } 


(D 在 onCreateDialog() 方 法 内 使 用 switch-case 语句 定义 各 类 对 话 框 。 

© 第 6 一 20 行 定 义 一 个 普通 对 话 框 。 分 别 使 用 setIconO ,setTitleO fll setMessage O Jy 
对 话 框 设置 图 标 、 标 题 和 显示 的 内 容 ; 第 10 一 18 行为 对 话 框 添加 “确定 ”按钮 ,其 显示 文本 由 
第 11 行 设 置 ,第 12 一 18 行为 该 按钮 添加 OnClickListener 监听 ,在 其 中 定义 当 按钮 被 单 击 时 ， 
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在 屏幕 的 EditText 控件 中 显示 来 自 字符 串 描述 文件 中 的 字符 串 内 容 ; 第 19 行 生成 该 对 
话 框 。 

@ 第 21~35 行 定义 一 个 列表 对 话 框 。 使 用 setItems 设置 列表 对 话 框 的 各 属性 ,其 中 有 
两 个 参数 ,第 一 个 参数 是 指定 列表 中 的 每 一 个 Item 的 文本 内 容 , 第 二 个 参数 是 为 列表 设置 
OnClickListener 监听 器 。 

(D 第 36—57 行 定义 一 个 单 选 列表 对 话 框 。 使 用 setSingleChoiceltems 设置 单 选 列表 选 
项 ,其 中 有 三 个 参数 ,第 一 个 参数 是 指定 列表 中 的 每 一 个 Item 的 文本 内 容 , 第 二 个 参数 是 默认 
被 选中 的 项 ,这 里 取 0 表示 第 一 项 被 选中 ,第 三 个 参数 是 为 列表 设置 OnClickListener 监听 器 ; 
第 50—55 行为 对 话 框 添加 一 个 “确定 ”按钮 并 添加 监听 。 

© 第 58 一 85 行 定义 一 个 复 选 列表 对 话 框 。 使 用 serMultiChoiceltems 设置 复 选 列表 选 
项 ,其 中 有 三 个 参数 ,第 一 个 参数 是 指定 列表 中 的 每 一 个 Item 的 文本 内 容 ,第 二 个 参数 是 默认 
被 选中 的 项 ,这 里 由 一 个 数组 提供 选择 项 ,第 三 个 参数 是 为 列表 设置 OnClickListener 监听 器 ; 
第 78 一 83 行为 对 话 框 添加 一 个 “确定 ”按钮 并 添加 监听 。 

© 第 86 一 103 行 定 义 一 个 日 期 对 话 框 。 使 用 DatePickerDialog 创建 一 个 日 期 对 话 框 ,其 
中 添加 了 OnDateSetListener 监听 器 。 

(D 第 104—119 行 定义 一 个 时 间 对 话 框 。 使 用 TimePickerDialog 创建 一 个 时 间 对 话 框 ， 
其 中 添加 了 OnTimeSetListener 监听 器 。 

@ 第 120 一 131 行 定义 一 个 进度 对 话 框 ,并 设置 进度 对 话 框 的 属性 。 

© 第 133 行 返回 生成 Dialog 的 对 象 ,结束 onCreateDialog() 方 法 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Activity Dialog 项 目 。 初 始 
运行 的 显示 效果 如 图 6-10 所 示 , 当 单 击 “显示 普通 对 话 框 ? 按 钮 后 屏幕 显示 如 图 6-11 所 示 , 当 
单 击 “显示 列表 对 话 框 ?按钮 后 屏幕 显示 如 图 6-12 所 示 , 当 单 击 * 显 示 单 选 按钮 对 话 框 ?按钮 后 
屏幕 显示 如 图 6-13 所 示 , 当 单 击 “ 显 示 复 选 框 对 话 框 ? 按 钮 后 屏幕 显示 如 图 6-14 所 示 , 当 单 击 
“显示 日 期 选择 对 话 框 ?按钮 后 屏幕 显示 如 图 6-15 所 示 , 当 单 击 * 显 示 时 间 选 择 对 话 框 ?按钮 后 
屏幕 显示 如 图 6-16 所 示 , 当 单 击 “ 显 示 进 度 对 话 框 ”按钮 后 屏幕 显示 如 图 6-17 所 示 。 


显示 普通 对 话 杠 


显示 列表 对 话 杠 [e] 列表 对 话 框 


显示 普通 对 话 框 
Bons HE 


ERARE 这 是 普通 对 话 框 中 的 内 容 ! ! ! 


显示 时 间 选 择 对 话 框 A 
显示 进度 对 话 框 2 


图 6-10 初始 运行 的 显示 效果 图 6-11 普通 对 话 杠 图 6-12 列表 对 话 框 
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© 单 选 按钮 对 话 框 Q sucum 


E 6-14 复 选 框 对 话 框 


图 6-15 日 期 对 话 框 图 6-16 ”时间 对 话 框 图 6-17 进度 对 话 框 


6.3 Android 应 用 案例 


下 面 通 过 一 个 应 用 项 目的 中 心 框架 设计 来 理解 本 章 中 所 介绍 的 内 容 。 

【案例 6.4】 完成 “掌上 微 博 ”的 日 志 查 看 与 编辑 功能 。 至 少 使 用 两 个 Activity, 第 一 个 
Activity 以 列表 的 方式 列 出 以 前 写 的 日 志 内 容 , 第 二 个 Activity 是 创建 或 编辑 日 志 。 

【说 明 】 这 两 个 Activity 是 实现 日 志 功能 的 核心 活动 ,它们 有 一 些 共 同 的 信息 要 显示 在 
界面 上 ,如 心情 图 标 .日 志 标题 和 写 日 志 时 间 等 ,有 些 变量 和 常量 是 两 个 Activity 共同 需要 的 。 
为 避免 重复 声明 常量 ,可 以 在 项 目的 包 内 定义 一 个 常量 类 ,将 多 个 Activity 需要 共用 的 常量 定 
义 在 这 个 常量 类 中 。 本 例 将 使 用 一 个 常量 类 。 

在 日 志 查看 Activity 中 ,设计 一 个 选项 菜单 ,用 于 新 增 或 删除 列表 中 的 日 志 。 如 果 新 增 日 
志 , 即 跳 转 到 日 志 编 辑 的 Activity 中 ,如 果 要 删除 某 条 日 志 , 系统 便 弹 出 对 话 框 以 供用 户 确认 
删除 操作 。 

在 日 志 编辑 的 Activity 中 ,只 编写 “返回 ”按钮 的 单 击 响 应 事件 ,对 另外 的 按钮 处 理 将 在 后 
续 章 节 中 完成 。 
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【开发 步骤 及 解析 】 
(1) Activity 的 功能 及 界面 设计 。 设 计 两 个 Activity, 一 个 是 日 志 查看 Activity, 用 于 显示 


志 信 息 列表 , 另 一 个 是 日 志 编辑 Activity, 用 于 日 志 信息 的 输入 和 修改 。 


O HERE Activity 界面 。 

扎 以 滚动 方式 , 按 条 目 显示 每 一 条 日 志 信 息 。 具 体 包括 : 心情 图 标 、. 日 志 标题 .日 志 的 建 
立 或 修改 时 间 “ 编 辑 " 和 ”删除 ?按钮 。 

扎 以 选项 菜单 形式 提供 “添加 ”“ 删 除 " 日 志 莱 单项 。 

避 单 击 “ 删 除 ”日 志 菜 单项 时 ,有 对 话 框 确认 。 

避 单 击 “ 添 加 ”日 志 菜 单项 时 ,进入 日 志 编 辑 Activity. 

@ 日 志 编 辑 Activity 界面 。 

所 显示 日 志 标题 .建立 日 志 的 时 间 、 心 情 图 标 、. 日 志 内 容 “ 保 在" 和 “返回 ?按钮 。 

忌 新 添加 的 日 志 开始 不 显示 建立 时 间 , 待 保 存 时 将 时 间 记 和 数据库。 

气 心 情 图 标 可 在 预 置 的 图 标 中 选择 。 

忌 每 一 条 日 志 必须 有 标题 和 内 容 。 

总 单 击 “ 返 回 ” 按 钮 , 则 返回 到 日 志 查看 Activity。 

(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ZSWB_Diaryl 的 Android 项 目 。 其 应 用 程序 


名 为 ZSWB, 包 名 为 cn. com. sgmsc. ZSWB. Activity 组 件 名 为 DiaryListActivity。 


(3) 准备 图 片 。 这 个 项 目 需 要 准备 一 套图 标 , 用 于 心情 图 标的 显示 ,将 制作 的 图 片 资 源 复 


制 到 本 项 目的 res/drawable-mdpi 目录 中 。 


CD 准备 字符 串 资 源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 «resources» 
3 < string name = "hello"» Hello World, ZSWB!«/string» 


4 < string name = "app_name"> 掌 上 微 博 </string> 

5 < string name = "ZSWB"> 掌 上 微 博 </string> 

6 

7 < string name = "tvStatus"> 心 情 : </string> 

8 < string name = "tvTitle"> 标 题 : </string> 

9 < string name = "hintDiary"> 写 点 什么 吧 !</string> 

10 < string name = "btnBack"> 返 回 </string> 

11 < string name = "btnPublishMofify"> 发 布 日 志 </string> 
12 < string name = "btnDelete"> 删 除 </string> 

13 < string name = "btnEdit"> 编 辑 </string> 

14 < string name = "btnOk"> 确 定 </string> 

15 < string name = "btnAdd"> 添 加 </string> 

16 < string name = "btnCancel"> 取 消 </string> 

17 < string name = "dialog_message"> 确 认 删 除 此 条 日 志 吗 ?</string> 
18 


19 </resources > 


(5) 创建 颜色 资源 。 创 建 并 编写 res/values 目录 下 的 颜色 描述 文件 colors. xml, 参 见 本 


书 源 代码 。 


(6) 创建 样式 资源 。 创 建 并 编写 res/values 目录 下 的 样式 描述 文件 style. xml, 参 见 本 书 


源 代码 。 


(7) 设计 浏览 日 志 布 局 。 重 命名 res/layout 目录 下 的 main. xml 文件 为 diarylist. xml, 并 
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编辑 之 。 代 码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android = "http: //schemas. android. con/apk/res/android" 


26 


android:orientation = "vertical" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:background = "(2 drawable/back" 
> 
<TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = " 按 menu 键 弹出 添加 菜单 …" 
/> 
XScrollView 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:fillViewport = "true" 
> 
<ListView 
android: id= "(à + id/listDiary" 
android:divider = "(Qcolor/listDivider" 
android:dividerHeight - "lpx" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:choiceMode = "singleChoice" 
/> 
</ScrollView> 


27 </LinearLayout > 


(8) 设计 编辑 日 志 布局 。 创 建 并 编写 res/layout 目录 下 的 其 他 布局 文件 ,名 为 diarydetail. 


xml。 代 码 如 下 所 示 。 


1 
2 
3 
4 
5 
6 
7 
8 
9 


10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 


<?xml version = "1.0" encoding = "utf - 8"?» 
< LinearLayout 


xmlns :android = "http: //schemas. android. com/apk/res/android" 
android:orientation = "vertical" 
android: background = "@drawable/back" 
android:layout width- "fill parent" 
android:layout height = "match parent" 
> 
< LinearLayout 
android:orientation = "horizontal" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
> <! -- 标题 部 分 --> 
< TextView 
android: text = "@string/tvTitle" 
style = "@style/text" 
android: layout width= "wrap content" 
android:layout height = "wrap content" 
/> 
<EditText 
android:id- "(à + id/etModifyTitle" 
android:layout width- "fill parent" 
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23 android:layout height = "wrap content" 

24 android:singleLine - "true" 

25 /> 

26 </LinearLayout > 

27 

28 «LinearLayout 

29 android:orientation = "horizontal" 

30 android:paddingLeft = "3dip" 

31 android:layout width- "fill parent" 

32 android:layout height = "wrap content" 

33 android:gravity- "center vertical" 

34 - 

35 < TextView 

36 android: id= "(9 + id/dttm" 

37 style= "(3style/tvDatetime" 

38 android:layout width = "wrap content" 

39 android:layout height = "wrap content" 

40 人 > «-- 日 期 时 间 部 分 --> 
41 <LinearLayout 

42 android:orientation = "horizontal" 

43 android: layout width= "match parent" 

44 android:layout height = "wrap content" 

45 android:gravity = "right" 

46 E <! -- 心情 部 分 --> 
47 < TextView 

48 style = "@ style/text" 

49 android:text = "@string/tvStatus" 

50 android:layout width- "wrap content" 

51 android:layout height = "wrap content" 

52 android:layout gravity = "center vertical" 
53 /> 

54 < Spinner 

55 android:id- "(9 + id/spinner face" 

56 android:layout width- "wrap content" 
57 android:layout height = "wrap content" 
58 android:layout gravity = "center vertical" 
59 android:drawSelectorOnTop = "false" 

60 /> 

61 «/LinearLayout > 

62 «/Linearlayout > 

63  «LinearLayout 

64 android:orientation = "horizontal" 

65 android:layout width- "fill parent" 

66 android:layout height - "fill parent" 

67 android:layout weight = "1" 

68 > <! -- 内 容 部 分 --> 
69 < EditText 

70 android:id= "@ + id/etModifyDiary" 

71 android:layout width- "fill parent" 

72 android:layout height = "fill parent" 

73 android: scrollbars = "vertical" 

74 android:gravity = "top" 

75 android:hint = "(8 string/hintDiary" 

76 /> 


77 </LinearLayout > 
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78 «LinearLayout 


79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 


android:orientation = "horizontal" 
android:gravity = "bottom" 
:layout_gravity = "center" 
id:layout width- "wrap content" 
android:layout height - "wrap content" 
> <! -- 按钮 部 分 --> 
< Button 
android: id= "(à + id/btnModifyDiary" 
style = "@style/button" 
android: text = "@string/btnPublishMofify" 
android: layout width= "120px" 
android:layout height = "wrap content" 
/> 
< Button 
android: id= "(9 + id/btnModifyDiaryBack" 
style = "@style/button" 
android: text = "@string/btnBack" 
android:layout width = "120px" 
android:layout height = "wrap content" 
/> 
</LinearLayout > 


100 </LinearLayout > 


(9) 开发 常量 类 代码 。 在 src/cn. com. sgmsc. ZSWB 包 下 创建 并 编写 常量 类 代码 文件 
ConstantUtil. java, 代 码 如 下 所 示 。 


package cn. com. sgmsc. ZSWB; 


public class ConstantUtil { 
public static int HEAD HEIGHT = 48; 


protected static final int[] FACEIDS - ( 
R. drawable. f_smile, R. drawable. f_tongue, R.drawable.f embarrassed, R.drawable.f love, 
R. drawable. f_cool, R. drawable. f_ninja, R. drawable. f_huh, R. drawable. f_wink, 


E: 
2 
3 
4 
5 public static int HEAD WIDTH = 48; 
6 
7 
8 
9 
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R.drawable.f crazy,R.drawable.f angry,R.drawable.f worried,R.drawable.f sadcry, 


R. drawable. f_rolleyes, R. drawable. f_ohhmy, R. drawable. f_wow 
h 


第 7 一 11 行 定义 一 个 数组 ,该 数组 是 所 有 的 心情 表情 图 标的 资源 id。 
(10) 开发 日 志 浏 览 代 码 。 打 开 src/cn. com. sgmsc. ZSWB 包 下 的 DiaryListActivity. java 
文件 ,并 编辑 之 。 这 个 文件 是 对 日 志 查 看 的 Activity 进行 逻辑 代码 设计 ,其 代码 如 下 所 示 。 


ooo 


package cn. com. sgnsc. ZSWB; 


import static cn. com. sgnsc. ZSWB. ConstantUtil.FACEIDS; 
import static cn. com. sgmsc. ZSWB. ConstantUtil. HEAD HEIGHT; 
import static cn. com. sgmsc. ZSWB. ConstantUtil.HEAD WIDTH; 


import android. app. Activity; 

import android. app. AlertDialog; 

import android. app.Dialog; 

import android. app. AlertDialog. Builder; 
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31 
32 
33 
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56 
57 
58 
59 
60 
61 
62 


63 


import android. content. Intent; 
import android. content. DialogInterface; 
import android. content. DialogInterface. OnClickListener; 


import android. grap! 


import android. os. Bı 
import android. view. 
import android. view. 
import android. view. 
import android. view. 
import android. view. 
import android. view. 


hics.Color; 


iundle; 

. Gravity; 

. View; 

. ViewGroup; 

. ViewGroup. LayoutParams; 
. Menu; 

. MenuItem; 


import android. widget. BaseAdapter; 
import android. widget. Button; 
import android. widget. ImageView; 
import android. widget. LinearLayout; 
import android. widget. ListView; 
import android. widget. TextView; 


public class DiaryListActivity extends Activity ( 


final int MENU ADD - Menu.FIRST; 


// 声 明 菜 单 选 行 的 ID 


final int MENU DELETE = Menu. FIRST + 1; // 声 明 菜单 项 的 编号 
final int DIALOG DELETE = 0; // 确 认 删 除 对 话 框 的 ID 
String [] diarysTitle; // 声 明 用 于 存放 日 志 标题 的 数组 
String [] diarysDatetime; // 声 明 用 于 存放 日 志 日 期 的 数组 
int [] diarysFace; // 声 明 用 于 存放 日 志 心 情 的 数组 
int [] diarysId; // 声 明 用 于 存放 日 志 id 的 数组 
int pos= -1; / /ListView 对 象 中 的 当前 项 位 置 
ListView lv; // 声 明 ListView 对 象 
BaseAdapter myAdapter = new BaseAdapter(){ 

@Override 

public int getCount() { 

if(diarysTitle != null){ // 如 果 日 志 数 组 不 为 空 


return diarysTitle. length; 
) 
else ( 
return 0; 
} 
} 
@Override 


// 如 果 日 志 数组 为 空 则 返回 0 


public Object getItem( int arg0) {return null;} 


@Override 


public long getItemId( int arg0) {return 0; } 


@Override 


public View getView( int position, View convertView, ViewGroup parent) { 


LinearLayout ll = new LinearLayout(DiaryListActivity. this);// 创 建 线性 布局 
11. setOrientation(LinearLayout. HORIZONTAL); 
ll.setGravity(Gravity.CENTER VERTICAL); 


// 定 义 日 志 列表 的 每 条 目的 内 容 , 包 括 心情 表情 图 标 、 标 题 ,创建 日 期 等 信息 
ImageView iv = new ImageView(DiaryListActivity.this); 
iv.setScaleType(ImageView.ScaleType.FIT CENTER); 


// 设 置 图 片 等 比 缩放 在 显示 区 域 中 央 


iv. setImageDrawable(getResources( ) . getDrawable(FACEIDS[ diarysFace[ position] ])); 
// 设 置 心情 图 片 


// 创 建 ImageView 对 象 
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iv.setLayoutParams(new LinearLayout. LayoutParams(HEAD WIDTH, HEAD HEIGHT)); 
iv.setPadding(3, 0, 0, 0); // 设 置 左边 界 空白 


LinearLayout 112 = new LinearLayout(DiaryListActivity.this); // 创 建 子 线性 布局 
112. setOrientation(LinearLayout. VERTICAL); 
112. setLayoutParams(new LinearLayout. LayoutParams(166,LayoutParams.WRAP CONTENT)); 
112. setPadding(3, 0, 0, 0); // 设 置 边界 空白 
TextView tvTitle = new TextView(DiaryListActivity.this); 
// 创 建 用 于 显示 日 志 标题 的 TextView 
tvTitle. setText(diarysTitle[ position]); // 设 置 日 志 标题 的 内 容 
tvTitle. setTextSize(18.0f); // 设 置 字体 大 小 
tvTitle. setTextColor(Color. BLUE); ” // 设 置 字体 颜色 


TextView tvDate = new TextView(DiaryListActivity. this); 

// 创 建 用 于 显示 日 志 创建 时 间 的 TextView 
tvDate. setTextSize(18.0f); // 设 置 字体 大 小 
tvDate. setTextAppearance(DiaryListActivity.this, R. style. content); 
tvDate. setText(diarysDatetime[position]); // 设 置 日 志 创建 时 间 的 内 容 
112. addView(tvTitle); // 将 显示 标题 的 TextView 添加 到 线性 布局 
112. addView(tvDate); // 将 显示 创建 时 间 的 Text Vien 添加 到 线性 布局 


LinearLayout llButton = new LinearLayout(DiaryListActivity. this); 
// 创 建 子 线性 布局 ,布局 按钮 
llButton. setOrientation(LinearLayout. HORIZONTAL) ; 
llButton. setLayoutParams(new LinearLayout. LayoutParams 
(LayoutParams.FILL PARENT, LayoutParams. WRAP_CONTENT) ) ; 
llButton. setPadding(3, 0, 3, 0); //setPadding 参数 : (left, top, right, bottom) 
llButton. setGravity(Gravity. RIGHT) ; 
Button btnEditDiary = new Button(DiaryListActivity. this); // 创 建 “ 编 辑 ” 按 钮 
btnEditDiary. setTextAppearance(DiaryListActivity.this, R. style. button); 
btnEditDiary. setLayoutParams(new LinearLayout. LayoutParams( 
50, LayoutParams. WRAP CONTENT)); 
btnEditDiary. setText(R. string. btnEdit); 
btnEditDiary. setId(position); // 设 置 Button 的 ID 
btnEditDiary. setOnClickListener(listenerToEdit); // 设 置 按钮 的 监听 器 
Button btnDeleteDiary = new Button(DiaryListActivity. this); // 创 建 “ 删 除 ” 按 钮 
btnDeleteDiary. setTextAppearance(DiaryListActivity. this, R. style. button); 
btnDeleteDiary. setLayoutParams(new LinearLayout. LayoutParams( 
50, LayoutParams.WRAP CONTENT)); 
btnDeleteDiary. setText(R. string. btnDelete); 
btnDeleteDiary. setId(position); // 设 置 Button 的 ID 
btnDeleteDiary. setOnClickListener(listenerToDelete); // 设 置 按钮 的 监听 器 
llButton. addView(btnEditDiary); 
llButton. addView(btnDeleteDiary); 
11.addView(iv); // 将 子 对象 添 加 到 父 布局 中 
11l. addView(112); 
11. addView(llButton); 


return 11; 


View.OnClickListener listenerToEdit - new View.OnClickListener() ( 
(GOverride 
public void onClick(View v) ( 


Intent intent-7 new Intent(DiaryListActivity. this, DiaryDetailActivity.class); 


183 


A 


184 


x 


Android 应 用 开发 教程 


118 ]; 


startActivity(intent); 


119 View.OnClickListener listenerToDelete - new View.OnClickListener() ( 


124 ); 


(QOverride 
public void onClick(View v) { 
showDialog(DIALOG DELETE); // 显 示 确 认 删 除 对 话 框 ,并 实施 相应 操作 


@Override 
public void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 
setContentView(R. layout.diarylist); 


lv = (ListView)findViewById(R. id. listDiary); // 获 得 ListView 对 象 的 引用 
lv. setAdapter(myAdapter); 
i 


// 创 建 选项 菜单 
@Override 


137 public boolean onCreateOptionsMenu(Menu menu) { 


141 } 


menu.add(0, MENU ADD, 0, R. string.btnAdd). setIcon(R. drawable. add); 
// 添 加 “添加 ”菜单 项 
menu.add(0, MENU DELETE, 0, R. string.btnDelete). setIcon(R. drawable. delete); 
// 添 加 “删除 ”菜单 项 


return true; 


142 // 定 义 菜单 项 被 选中 后 的 回调 事件 
143 @Override 
144 public boolean onOptionsItemSelected(MenuItem item) { 


switch(item.getItemId())( // 判 断 按 下 的 菜单 选项 

case MENU ADD: // 按 下 了 “添加 ”菜单 
Intent intent = new Intent(DiaryListActivity. this,DiaryDetailActivity. class); 
startActivity( intent); 
break; 

case MENU DELETE: // 按 下 了 “删除 ”菜单 


pos = DiaryListActivity. this. lv. getSelectedItemPosition(); 

// 取 ListView 当前 项 的 ID 
showDialog(DIALOG DELETE); // 显 示 确 认 删 除 对 话 框 , 并 实施 相应 操作 
break; 

) 


return true; 


158 // 创 建 对 话 框 
159 @Override 
160 protected Dialog onCreateDialog(int id) { 


Dialog dialog = null; 
suitch(id)( // 对 对 话 框 ID 进行 判断 
case DIALOG DELETE: // 创 建 删除 确认 对 话 框 
Builder b = new AlertDialog. Builder(this); 
b. setIcon(R. drawable.dialog delete); // 设 置 对 话 框图 标 
b. setTitle( "提示"); // 设 置 对 话 框 标题 
b.setMessage(R.string.dialog message);  // 设 置 对 话 框 内 容 
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168 b. setPositiveButton(R. string. btnOk, 

169 newOnClickListener() { // 按 下 对 话 框 中 的 “确认 ”按钮 
170 @Override 

171 public void onClick(DialogInterface dialog, int which) { 
172 deleteDiary(diarysId[pos]);  — // 调 用 删除 处 理 方法 
173 } 

174 n; 

175 b. setNegativeButton(R. string. btnCancel, 

176 newOnClickListener() { // 按 下 对 话 框 中 的 “取消 ”按钮 
177 @Override 

178 public void onClick(DialogInterface dialog, int which) {} 
179 ni 

180 dialog 7 b.create(); 

181 break; 

182 ] 

183 return dialog; 

184 } 

185 

186 // 方 法 : 删除 指定 的 日 志 记录 

187 public void deleteDiary(int id){ //id 为 要 删除 记录 的 id 

188 //.…… 定 义 删除 日 志 代码 

189 } 

190 

191 } 


(D $ 40—111 行 定 义 了 一 个 BaseAdapter 类 的 对 象 myAdapter, 用 于 显示 日 志 的 列表 ， 
当 没 有 写 任 何 日 志 时 这 个 列表 是 空 的 。 尽 管 刚 开始 这 里 是 空 的 ,但 是 在 这 里 也 要 先 定义 好 列 
表 条 目的 显示 布局 。 第 61 一 65 行 定义 了 图 标的 布局 属性 ; 第 67 一 81 行 定 义 一 个 内 嵌 的 纵向 
线性 布局 ,在 其 中 添加 两 个 TextView 控件 ,分 别 显示 日 志 标题 和 日 志 创建 日 期 ; 第 83 一 104 
行 定 义 一 个 内 嵌 的 横向 线性 布局 ,其 中 添加 两 个 按钮 ,第 一 个 按钮 btnEditDiary 被 单 击 时 ,将 
跳 转 到 DiaryDetailActivity, 这 部 分 由 第 112—118 行 代码 实现 ; 第 二 个 按钮 btnDeleteDiary 
被 单 击 时 ,将 调 出 一 个 对 话 框 ,这 部 分 由 第 119 一 124 行 代码 实现 。 

© 第 137 —141 行 定 义 选项 菜单 的 创建 方法 。 

@ 第 144 一 156 行 定义 菜单 项 被 选中 后 的 回调 事件 , 当 单 击 “ 添 加 ”菜单 项 时 , 跳 转 到 
DiaryDetailActivity 中 , 当 单 击 “ 删 除 ”菜单 项 时 , 调 出 一 个 对 话 框 。 

@ 第 160—184 行 定义 创建 对 话 框 方法 ,这 个 对 话 框 是 在 “删除 ?菜单 项 时 被 调 出 。 其 中 ， 
第 168—174 行 定义 “确定 ”按钮 的 onClick 事件 , 它 将 执行 删除 指定 的 日 志 项 内 容 ; 第 175 一 
179 行 定义 “取消 ”按钮 的 onClick 事件 。 

(OD 开发 日 志 编 辑 代 码 。 创 建 并 编写 src/cn. com. sgmsc. ZSWB 包 下 的 DiaryDetailActivity. 
java 文件 ,该 文件 是 对 日 志 编 辑 的 Activity 进行 逻辑 代码 设计 ,其 代码 如 下 所 示 。 


package cn. com. sgmsc. ZSWB; 
import static cn. com. sgmsc. ZSWB. ConstantUtil. FACEIDS; 


1 
2 
3 
4 
5 import android.app. Activity; 

6 import android. content. Intent; 

7 import android. os. Bundle; 

8 import android. view. View; 

9 import android. view. ViewGroup; 

10 import android. widget. AdapterView; 


185 


RA 


186 


Nf 


Android 应 用 开发 教程 


11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 


47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 


64 
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66 


import android. widget. 
import android. widget. 
import android. widget. 
import android. widget. 
import android. widget 
import android. widget. 
import android. widget 


. Button; 

. EditText; 

. ImageView; 

. TextView; 

. Spinner; 

. BaseAdapter; 

. AdapterView. OnItemSelectedListener; 


public class DiaryDetailActivity extends Activity 


EditText etModifyTit 
EditText etModifyCont 
TextView tvdttm = nul. 
Spinner facesp = null 


(QOverride 


le = null; // 显 示 日 志 标题 的 EditText 
tent - null; // 显 示 日 志 内 容 的 EditText 

l; // 显 示 日 志 创建 时 间 的 TextView 
H // 显 示 心 情 的 Spinner 


protected void onCreate(Bundle savedInstanceState) { 


super. onCreate( 
setContentView( 


savedInstanceState); 
R. layout. diarydetail); 


etModifyTitle = (EditText)findViewById(R. id.etModifyTitle);  // 获 得 标题 的 EditText 
etModifyContent = (EditText)findViewById(R. id. etModifyDiary); // 获 得 内 容 的 EditText 
tvdttm = (TextView)findViewById(R.id.dttm); // 获 得 日 期 时 间 的 TextView 


facesp = (Spinner)findViewById(R. id. spinner face); // 获 得 心情 的 Spinner 
BaseAdapter ba = new BaseAdapter()( // 为 Spinner 准备 内 容 适 配器 

@Override 

public int getCount() {return 15; } // 总 共 15 个 选项 

@Override 


public Object getItem(int arg0) { return null; } 


GOverrid 


le 


public long getItemId(int arg0) ( return 0; } 


@Overrid 


le 


public View getView(int arg0, View argl, ViewGroup arg2) { 
// 初 始 化 ImageView 
ImageView iv= new ImageView(DiaryDetailActivity. this); 


iv. 


setImageDrawable(getResources().getDrawable(FACEIDS[arg0])); 


// 设 置 图 片 
return iv; 

} 
}; 
facesp. setAdapter(ba); // 8 Spinner 设置 内 容 适 配器 
facesp. setOnItemSelectedListener( /设置 选项 选中 的 监听 器 

new OnItemSelectedListener()( 

(2 Override 


public void onItemSelected(AdapterView <?> arg0, View argl, 


int arg2, long arg3) { 


//.…… 定 义 选项 被 选中 事件 的 处 理 方法 


} 


@Override 
public void onNothingSelected(AdapterView <?> arg0) {} 


} 
); 


Button btnModifyBack = (Button)findViewById(R. id. btnModifyDiaryBack); 


// 获 得 “返回 ?按钮 


btnModifyBack. setOnClickListener(new View. OnClickListener() { 


(GOverride 


public void onClick(View v) { 


Som 菜单 与 对 话 框 


67 Intent intent = new Intent(DiaryDetailActivity. this, DiaryListActivity.class); 
68 startActivity(intent); 


(D 58 35—49 行 定 义 BaseAdapter 对 象 ba. 绑 定 心 情 表情 图 标 数 据 。 

© 第 51 一 61 行为 facesp 添加 OnItemSelectedListener 监听 。 

© 第 64 一 70 行 设置 “返回 ?按钮 的 OnClickListener 监听 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 KDWB Diaryl 项 目 。 初 始 运 


行 时 , 当 按 下 手机 (或 模拟 器 ) 中 的 menu 键 时 ,屏幕 显示 如 图 6-18 所 示 , 当 单 击 “ 删 除 ” 菜 单项 


rH] 


上 时 显示 界面 如 图 6-19 所 示 , 当 单 击 “ 添 加 ”菜单 项 时 进入 日 志 编 辑 界面 如 图 6-20 所 示 ,在 此 界 


单 击 “ 心 情 ” 下 拉 列 表 框 时 下 拉 出 心情 图 标 列表 如 图 6-21 所 示 。 


图 6-19 单 击 “ 删 除 ”菜单 调 出 对 话 框 


图 6-20 单 击 “添加 ”菜单 进入 编辑 日 志 界面 图 6-21 单 击 “ 心 情 ” 下 拉 列 表 , 列 出 心情 图 标 


本 章 介 绍 了 应 用 程序 中 常用 的 菜单 和 对 话 框 的 类 型 及 其 创建 .设置 和 回调 事件 的 处 理 。 
并 举例 说 明了 它们 的 使 用 。 在 创建 并 使 用 菜单 和 对 话 框 时 ,有 几 个 重要 的 方法 及 开发 步骤 必 
须 理解 掌握 。 

至 本 章 ,Android 系统 提供 的 屏幕 显示 控件 的 介绍 要 告 一 段落 了 ,通过 学 习 读者 已 经 具备 
了 设计 出 各 种 各 样 用 户 界面 的 能 力 。 接 下 来 需要 进 阶 学 习 Android 应 用 程序 的 数据 存储 、 消 
息 传递 ,线程 控制 等 知识 ,掌握 Android 应 用 的 深层 开发 技术 。 


设计 “掌上 微 博 ” 的 相册 管理 模块 用 户 界面 。 在 “掌上 微 博 ”中 用 户 可 以 定义 多 个 相册 ,每 
个 相册 内 包括 多 个 照片 .照片 说 明 及 拍摄 日 期 等 信息 。 要 求 至 少 使 用 两 个 Activity, 第 一 个 
Activity 以 列表 的 方式 列 出 已 有 的 相册 标题 ,并 使 用 选项 菜单 设置 “新 增 ? 相 册 和 ”删除 ?相册 
菜单 项 ; 第 二 个 Activity 联合 使 用 ImageSwitcher 和 Gallery 控件 显示 指定 相册 中 的 照片 ,并 
添加 “拍照 >"“ 返 回 ? 按 钮 。 


Android 数 据 存储 | 


程序 本 身 就 是 数据 的 输入 、 处 理 和 输出 的 过 程 ,不 管 是 操作 系统 还 是 应 用 程序 都 不 可 
避免 地 要 用 到 大 量 的 数据 。 因 此 ,数据 存储 是 程序 最 基本 的 问题 。 在 手机 这 种 特殊 设备 
里 ,也 经 常会 进行 存 取 数据 处 理 , 例 如 , 存 取 通讯 录 、 图 片 文件 .音频 文件 和 视频 文件 等 数据 
的 处 理 。 

在 Android 系统 中 ,所 有 应 用 程序 的 数据 为 该 应 用 程序 所 私有 ,同时 也 提供 了 多 个 应 用 程 
序 之 间 的 数据 通信 标准 方式 。 作 为 一 种 手机 操作 系统 ,Android 系统 提供 了 以 下 几 种 数据 存 
储 和 数据 共享 方式 : Preference BO , File X: ff) , SQLite li Æ , ContentProvider, SD Card 
和 网 络 。 关 于 网 络 数据 存储 将 在 第 10 章 中 详细 介绍 ,下 面 针 对 本 地 的 几 种 存储 方式 进行 
介绍 。 


d Preference 存储 


Preference 提供 了 一 种 轻 量 级 的 数据 存 取 方 法 ,一般 用 于 数据 较 少 的 配置 信息 的 存储 场合 。 
例如 ,一 些 登 录 的 用 户 名 和 密码 ,一些 默认 的 应 用 项 目 问候 词 ,程序 关闭 前 界面 的 主要 属性 值 等 。 
使 用 Preference 方式 来 存 取 数据 ,用 到 了 SharedPreferences 接口 和 SharedPreferences 中 的 一 个 内 
部 接口 SharedPreferences. Editor, 这 两 个 接口 都 在 android. content 包 中 。 

SharedPreferences 类 似 于 桌面 操作 系统 中 常用 的 ini 文件 , 它 以 * 键 - 值 ? 对 的 方式 将 数据 
保存 到 一 个 内 部 的 XML 配置 文件 中 ,用 来 保存 应 用 程序 的 一 些 属 性 设置 。 如 果 在 Android 
的 应 用 程序 中 使 用 了 SharedPreferences 保存 数据 ,可 以 通过 ADT 的 DDMS 透视 图 来 查看 数 
据 文件 的 位 置 。 方 法 是 在 Eclipse 的 DDMS 中 ,打开 File Explorer 标签 页 ,展开 到 /data/ data/ 
— package name /shared prefs 下 ,可 以 看 到 相应 的 XML 文件。 以 “掌上 微 博 ” 为 例 ,展开 
/ data/data/cn. com. sgmsc. ZSWB/shared_prefs, 可 以 看 到 “掌上 微 博 ”的 配置 文件 SPDATA_ 
Files. xml, 如 图 7-1 所 示 。 注 意 , 只 有 在 打开 了 Android 的 模拟 器 后 ,File Explorer 页 内 才 有 
内 容 。 

每 个 应 用 程序 都 有 一 个 SharedPreferences 对 象 。 调 用 Context. getSharedPreferences 
(String name,int mode) 方法 获取 SharedPreferences 对 象 ,其 中 第 一 个 参数 name 为 本 组 件 
的 配置 文件 名 ; 第 二 个 参数 mode 是 操作 模式 ,操作 模式 有 三 种 : MODE_PRIVATE( 值 为 0， 
应 用 程序 私有 ,常用 )、MODE_WORLD_READABLE( 值 为 1, 其 他 程序 可 读 ) 和 MODE_ 
WORLD_WRITEABLE( 值 为 2, 其 他 程序 可 写 )。 

SharedPreferences 提供 了 获得 数据 的 方法 ,调用 SharedPreferences 的 edit() 方 法 返回 
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7-1 展开 的 /data/data/cn. com. sgmsc. ZSWB/shared prefs 目录 内 容 


SharedPreferences. Editor 内 部 接口 ,该 接口 中 提供 了 保存 数据 的 方法 ,这 些 常 用 的 方法 如 
K 7-1 和 表 7-2 所 示 。 


表 7-1 SharedPreferences 常用 方法 及 说 明 


5 —* Hx 
edit O 返回 SharedPreferences 的 内 部 接口 SharedPreferences. Editor 
contains (String key) 判断 是 否 包含 该 键 值 
getAll O 返回 所 有 配置 信息 的 Map 
getBoolean(String key,boolean defValue) 获得 一 个 boolean 值 
getFloat(String key,float defValue) 获得 一 个 float 值 
getInt(String key,int defValue) 获得 一 个 int 值 
getLong (String key,long defValue) 获得 一 个 long 值 
getString (String key, String defValue) 获得 一 个 String 值 


表 7-2 SharedPreferences. Editor 常用 方法 及 说 阴 


5 È 描 x 
clear () 清除 所 有 值 
commit( ) 保存 
getAll () 返回 所 有 配置 信息 的 Map 
putBoolean(String key,boolean value) 保存 一 个 boolean 值 
putFloat (String key.float value) 保存 一 个 float 值 
putInt(String key,int value) 保存 一 个 int 值 
putLong (String key.long value) 保存 一 个 long 值 
putString (String key, String value) 保存 一 个 String 值 
Temove (String key) 删除 该 键 对 应 的 值 


SharedPreferences 对 象 的 数据 读 取 设计 步骤 为 : 获取 SharedPreferences 对 象 的 键 key. 


再 由 key 获取 相应 的 键 值 , 在 这 里 ,对 于 不 同类 型 的 键 值 有 不 同 的 get() 方 法 。SharedPreferences 
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对 象 的 数据 写 和 人 设计 步骤 为 : 通过 SharedPreferences 的 Editor 对 象 ,设置 键 值 ,然后 调用 
commit() 提 交 设 置 , 写 人 XML 文件 。 下 面 通过 一 个 案例 来 说 明 SharedPreferences 的 具体 
用 法 。 

【案例 7.1】 在 “掌上 微 博 ” 的 用 户 登 录 界 面 中 ,增加 一 个 复 选 框 “ 记 住 我 ?。 当 勾 选 了 该 
复 选 框 后 ,系统 的 用 户 登录 Activity 将 保存 最 近 的 一 次 用 户 登录 信息 。 

【说 明 】 以 第 4 章 的 案例 4. 14 创建 的 项 目 ZSWB Loginl 为 基础 ,在 界面 布局 中 添加 一 
个 复 选 框 ,并 在 代码 中 增加 如 下 生命 周期 方法 的 重 定 义 : onStop() 和 onDestroy()。 

使 用 SharedPreferences 对 账号 和 密码 的 输入 信息 进行 存 取 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ZSWB_Login2 的 Android 项 目 。 其 应 用 程序 
名 为 ZSWB, 包 名 为 cn. com. sgmsc. ZSWB, Activity 组 件 名 为 Login2Activity。 

(2) 准备 图 片 。 从 项 目 ZSWB_Loginl 中 复制 图 片 资源 到 本 项 目的 res/drawable-mdpi H 
录 中 。 

(3) 准备 其 他 资源 。 从 项 目 ZSWB_Loginl 中 复制 res/values 目录 下 的 colors. xml, 
strings. xml 和 styles. xml 文件 到 本 项 目的 res/values 目录 中 。 

(4) 设计 布局 。 从 项 目 ZSWB_Loginl 中 复制 res/layout 目录 下 的 login. xml 文件 到 本 项 
目的 res/layout 目录 中 ,并 删除 main. xml 文件 。 修 改 login. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?> 


2 <LinearLayout  …… > <! -- 声明 垂直 分 布 的 线性 布局 --> 
3 <TextView «ee > 

4 </TextView > 

5 XLinearLayout ~. > 
6 <TextView  …… /> 

7 «EditText 人 > 

8 </LinearLayout > 

9 XLinearLayout ee- > 
10 <TextView ==. 人 > 

11 <EditText  …… /> 

12 </LinearLayout > 

13 


14 <! -- 新 增加 的 LinearLayout --> 
15 <LinearLayout 


16 android:orientation = "horizontal" 

17 android: layout_gravity = "center horizontal" 
18 android:layout width- "wrap content" 

19 android:layout height = "wrap content" 

20 > 

21 < CheckBox 

22 android: id= "(8 + id/cbRemember" 

23 android: text = "(à string/cbRemember" 
24 style = "@style/text" 

25 android: layout_width = "fill_parent" 
26 android:layout height = "wrap content" 
217 android:layout gravity = "center vertical" 
28 android:checked = "false" 

29 /> 

30 </LinearLayout > 
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32 <LinearLayout ~ > <! -- 声明 与 显示 按钮 的 线性 布局 --> 
33 «Button …  /» 

34 «Button …  /» 

35 «/LinearLayout > 


36 «/LinearLayout > 


CD 与 案例 4. 14 B Je XC PER IL CIS T IC ER e 8 HI IRE 

Q 第 22—28 行 是 本 案例 增加 的 内 容 。 

(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. ZSWB 包 下 的 Login2Activity. java 文件 ， 
并 编辑 之 ,代码 如 下 所 示 。 


package cn. con. sgnsc. ZSWB; 


E: 

2 

3 import android. app. Activity; 

4 import android. content. SharedPreferences; 
5 import android. os. Bundle; 

6 import android. widget. CheckBox; 

7 import android. widget. EditText; 

8 
9 


public class Login2Activity extends Activity ( 


10 

11 public static final String SP INFOS - "SPDATA Files"; 

12 public static final String USERID - "UserID"; 

13 public static final String PASSWORD - "PassWord" ; 

14 private static EditText etUid; // 接 收 用 户 id 组 件 
15 private static EditText etPwd; // 接 收 用 户 密码 组 件 
16 private static CheckBox cb; /A/* 记 住 我 " 复 选 框 组 件 
17 private static String uidstr; // 用 户 账号 

18 private static String pwdstr; // 用 户 密码 

19 

20 (QOverride 

21 public void onCreate(Bundle savedInstanceState) ( 

22 super. onCreate(savedInstanceState); 

23 setContentView(R. layout. login); 

24 etUid = (EditText) findViewById(R. id. etUid); // 获 得 账号 EditText 
25 etPwd- (EditText) findViewById(R. id. etPwd) ; // 获 得 密码 EditText 
26 cb = (CheckBox) findViewById(R. id.cbRemember);  // 获 得 CheckBox 对 象 
27 checkIfRemember( ); // 从 SharedPreferences 中 读 取 用 户 的 账号 和 密码 
28 } 

29 @Override 

30 protected void onStop(){ 

31 super. onStop() ; 

32 if(cb. isChecked() ){ 

33 uidstr = etUid.getText().toString().trim(); // 获 得 输入 的 账号 

34 pwdstr = etPwd.getText().toString().trim(); // 获 得 输入 的 密码 

35 rememberMe(uidstr, pwdstr); // 将 用 户 的 账号 与 密码 存 人 SharedPreferences 
36 } 

37 } 

38 @Override 

39 protected void onDestroy() { 

40 super. onDestroy() ; 


4l ] 


第 7 章 ”Android 数 据 存 储 


42 

43 // 方 法 : 从 SharedPreferences 中 读 取 用 户 的 账号 和 密码 

44 public void checkIfRemember()( 

45 SharedPreferences sp = getSharedPreferences(SP INFOS,MODE PRIVATE); 

46 // 获 得 Preferences 

47 uidstr = sp.getString(USERID, null); // 取 Preferences 中 的 账号 
48 pwdstr = sp.getString(PASSWORD, null); // 取 Preferences 中 的 密码 
49 if(uidstr != null && pwdstr!= null)( 

50 etUid. setText(uidstr); // 给 EditText 控件 赋 账 号 
51 etPud. setText(pudstr) ; // 给 EditText 控件 赋 密 码 
52 cb. setChecked(true); 

53 } 

54 } 

55 

56 // 方 法 : 将 用 户 的 id 和 密码 存 人 SharedPreferences 

57 public void rememberMe(String uid, String pwd)( 

58 SharedPreferences sp = getSharedPreferences(SP INFOS,MODE PRIVATE); 

59 // 获 得 Preferences 

60 SharedPreferences.Editor editor = sp.edit(); // 获 得 Editor 

61 editor. putString(USERID, uid); // 将 用 户 账号 存 人 Preferences 
62 editor. putString(PASSWORD, pwd); // 将 密码 存 人 Preferences 
63 editor. commit( ); 

64 } 

65 

66 ] 


O 第 11 一 13 行 定 义 了 三 个 字符 串 常量 ,分 别 代表 配置 文件 名 ,账号 的 键 名 、 密 码 的 键 名 。 

@ 第 21 一 28 行 重 写 onCreate() 方 法 。 其 中 第 27 行 的 checkIfRemember() 是 自 定义 方 
法 , 它 将 完成 从 SharedPreferences 中 读 取 用 户 的 账号 和 密码 。 

© 第 44 一 54 行 是 定义 checkIfRemember() 方 法 。 其 中 ,第 45 行 是 获取 SharedPreferences 对 
象 sp; 58 47,48 行 分 别 取得 账号 值 和 密码 值 ; 第 51,52 行 分 别 向 账号 和 密码 的 Edit Text 控件 
中 传人 取得 的 值 ,并 将 “ 记 住 我 " 复 选 框 设置 为 选中 状态 。 

CD $ 30—37 行 重 写 onStop() 方 法 。 其 中 第 35 行 的 rememberMe(uidstr, pwdstr) 是 自 
定义 方法 , 它 将 完成 把 用 户 的 账号 与 密码 存 人 到 SharedPreferences 中 。 

© 第 57 一 64 行 是 定义 rememberMe(uidstr,pwdstr) 方 法 。 其 中 ,第 60 行使 用 edit() 方 
法 获得 一 个 SharedPreferences 的 Editor 对 象 editor; 第 61,62 行 是 将 用 户 的 账号 值 和 密码 值 
写 到 editor 对 象 中 ; 第 63 行将 editor 对 象 保存 到 SharedPreferences 中 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 项 目 KDWB_Login2。 首 次 运 
行 时 因为 没有 输入 任何 信息 ,所 以 账号 和 密码 都 是 空 的 ,屏幕 显示 如 图 7-2 所 示 。 当 在 “账号 ” 
编辑 框 和 “密码 ”编辑 框 中 输入 了 相关 信息 ,并 勾 选 了 “ 记 住 我 " 复 选 框 后 ,退出 该 项 目 , 然 后 青 
次 进入 KDWB. Login2 时 可 以 看 到 上 次 输入 的 账号 和 密码 自动 显示 在 编辑 框 内 ,屏幕 显示 如 
图 7-3 所 示 。 

使 用 SharedPreferences 的 存储 方式 非常 方便 ,但 是 它 只 适合 存储 比较 简单 且 内 容 少 的 数 
据 , 如 果 需 要 存储 更 多 的 数据 ,就 必须 使 用 其 他 的 存储 方式 了 。 
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掌上 微 博 


myHoney 


图 7-2 首次 运行 本 项 目的 显示 效果 图 7-3 选中 “ 记 住 我 ”, 再 次 运行 的 显示 效果 


(.2 文件 存储 


可 以 将 一 些 数据 以 文件 的 形式 保存 在 设备 中 ,例如 ,一 些 文本 文件 .PDF 文件 .图片 文件 、 
音频 文件 和 视频 文件 等 。 

使 用 文件 存储 ,Java 的 L/O 包 中 的 常用 类 也 可 以 正常 工作 在 Android 平台 上 ,例如 : 
Java. io. BufferedReader, Java. io. BufferedWriter, Java. io. FileReader. Java. io. FileWriter， 
Java. io. FileOutputStream. Java. io. FileInputStream. Java. io. OutputStream, Java. io. InputStream, 
Java. io. OutputStreamWriter. Java. io. InputStreamReader. Java. io. PrintStream. Java. io. 
PrintWriter, Java. io. FileNotFoundException 和 Java. io. IOException 等 。 

在 Android 中 ,可 以 通过 openFileOutput() 方 法 打开 一 个 指定 的 文件 ,通过 load() 方 法 来 
获取 文件 中 的 数据 ,通过 deleteFile() 方 法 来 删除 一 个 指定 的 文件 ,通过 openFileInput ) 方 法 
写 和 人 文件 ,等 等 。 例 如 使 用 文件 代码 段 : 


String FILE_NAME "infofile. txt"; // 获 取 要 操作 文件 的 文件 名 
FileOutputStream fos = openFileOutput(FILE_NRME, Context. NODE_PRIVATE) ; // 初 始 化 一 个 文件 流 
FileInputStream fis = openFileInput(FILE NAME); // 创 建 写 入 文件 流 


注意 ,在 使 用 上 述 文件 流 读 写 方法 时 ,只 能 对 当前 应 用 程序 所 在 目录 下 的 文件 进行 操作 。 
即 指定 的 文件 名 中 不 能 包含 路 径 。 如 果 调 用 FileOutputStream 时 指定 的 文件 不 存在 ， 
Android 系统 会 自动 创建 它 。 在 默认 情况 下 , 写 入 操作 是 覆盖 式 的 写 和 人 ,如 果 需 要 把 新 的 数据 
写 入 到 文件 中 ,而 不 覆盖 原文 件 内 容 , 则 要 将 openFileOutput() 方 法 的 第 二 个 参数 设置 为 
Context. MODE_APPEND。 

在 Android 中 对 文件 的 存储 操作 与 传统 的 Java 对 文件 实现 1/0 的 程序 类 似 , 在 此 不 作 
JOE. 
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(.3 SQLite 数据 库 
w 


Android 平台 中 内 能 一 个 轻 量 级 的 、 功 能 强大 的 关系 数据 库 SQLite, 用 于 完成 各 种 复杂 的 
数据 处 理 , 实 现 结构 化 的 数据 存储 。 

SQLite 数据 库 是 一 种 关系 数据 库 ,支持 多 数 的 SQL92 标准 ,最 大 支持 数据 库 到 2TB。 它 
没有 服务 进程 ,是 一 种 嵌入 到 应 用 程序 内 部 的 数据 库 , 所 包含 的 数据 库 、 表 等 所 有 数据 都 存放 
在 一 个 单一 的 文件 中 。 可 以 通过 ADT 的 DDMS 透视 图 来 查看 数据 库 文件 的 位 置 。 即 在 
Eclipse 的 DDMS 中 ,打开 File Explorer 标签 页 , J£ JF $]/data/data/— package name >/ 
databases 下 ,可 以 看 到 相应 的 数据 库 文件 。 例 如 ,展开 /data/data/cn. com. sgmsc. ZSWB/ 
databases, 可 以 看 到 “掌上 微 博 ” 的 数据 库 文件 。 在 默认 情况 下 ,SQLite 数据 库 文件 属于 应 用 
程序 所 私有 , 且 数据 库 的 名 字 是 唯一 的 。 

Android 提供 了 创建 和 使 用 SQLite 数据 库 的 API, 以 及 一 些 类 与 接口 ,下 面 分 别 介绍 。 


7.3.1 SQLite 数据 库 相 关 的 类 与 接口 
1. SOLiteDatabase 类 


SQLiteDatabase 类 位 于 android. database. sqlite 包 下 ,一 个 SQLiteDatabase 对 象 代表 一 
个 数据 库 。 在 Android 平台 下 ,可 以 通过 SQLiteDatabase 类 的 静态 方法 创建 或 打开 数据 库 ， 
以 及 对 数据 库 的 记录 进行 增 \ 删 \ 改 、 查 等 操作 。 

2. SOLiteOpenHelper 类 

SQLiteOpenHelper 类 位 于 android. database. sqlite 包 下 , 它 是 一 个 辅助 类 , 主要 用 来 管 
理 数据 库 的 创建 和 版 本 。SQLiteOpenHelper 是 一 个 抽象 类 ,使 用 时 通常 需要 创建 子 类 继承 
"E ,并 实现 两 个 抽象 方法 onCreate() 和 onUpgradeO 。 

3. Cursor 接口 


Cursor 位 于 android. database 43 F , 它 是 Android 的 一 个 非常 有 用 的 游标 接口 ,通过 
Cursor 可 以 对 数据 库 的 查询 结果 集 进 行 随机 的 读 写 访问 。 


4. ContentValues 类 


Content Values 类 位 于 android. content f F , 它 存储 一 些 键 - 值 对 ,提供 了 数据 库 的 列 名 、 
数据 映射 信息 。ContentValues 的 键 是 一 个 String 类 型 的 数据 ,对 应 数据 库 中 的 列 名 ; 而 其 相 
应 的 值 是 基本 数据 类 型 ,对 应 数据 库 的 数据 ,所 以 ContentValues 对 象 代表 了 数据 库 的 一 行 
数据 。 


7.8.2 管理 SOLite 数据 库 相关 的 方法 及 编程 


在 Android 中 ,通过 上 述 类 的 相关 方法 来 对 SQLite 数据 库 进行 创建 和 管理 。 下 面 分 别 介 
绍 常用 的 方法 及 其 用 法 。 
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1. 相关 方法 


SQLiteDatabase 中 常用 的 方法 如 表 7-3 所 示 。 
表 7-3 SQLiteDatabase 的 常用 方法 及 说 明 


方 法 参 数 描 述 
path: 指定 路 径 的 数据 库 文件 
factory: 构造 查询 时 返回 的 Cursor 
对 象 
openDatabase(String path, SQLiteDatabase. | flags: 打开 模式 ,模式 参数 包括 : 
CursorFactory factory ,int flags) OPEN READONLY( Hi£Jr 35 ; use 
OPEN READWRITE(H[ i£ n] 5$); 
CREATE IF NECESSARY (4 Sit di 
库 文件 不 存在 时 ,创建 该 数据 库 ) 
openOrCreateDatabase ( String path, 同上 aprire 
SQLiteDatabase. CursorFactory factory) IF NECESSARY 的 情形 
create ( SQLiteDatabase. CursorFactory 同上 创建 一 个 内 存 数据 库 
factory) 
table: 数据 表 名 称 
SA maoaad; nullColumnHack: 空 列 的 默认 值 添加 一 条 记录 
values: 封装 了 列 名 和 列 值 的 Map 
table: 数据 表 名 称 
pil cura Um WhereClause，| whereClause: 删除 条 件 删除 一 条 记录 
whereArgs: 删除 条 件 值 数组 
table: 数据 表 名 称 
update (String table, ContentValues nnd TM Concutvalues de Mf 
Piceni whereClause, String [ ] whereClause; 更 新 条 件 ( 即 where 修改 记录 
子 句 ) 
whereArgs: 更 新 条 件 值 数组 
. table; 数据 表 名 称 
guery touring table, columns, 列 名 数组 
iiw Sp selections 条 件 子 句 ,相当 于 where 
String[ ] selectionArgs, 人 
String groupBy， 数组 E ske 
Se eine groupBy: 分 组 的 列 名 
String orderBy) kaving: t 
orderBy: 排序 的 列 名 
execSQL String sql) sql: SQL 语句 执行 一 条 SQL 语句 
close() 关闭 数据 库 


Cursor 中 常用 的 方法 如 表 7-4 所 示 。 
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表 7-4 Cursor 的 常用 方法 及 说 明 


5 d do à g 
getCount() 游标 结果 集 的 总 记录 条 数 
isFirst() 判断 是 否 是 第 一 条 记录 
isLast() 判断 是 否 是 最 后 一 条 记录 
move(int offset) 移动 到 指定 记录 
moveToFirst() 移动 到 第 一 条 记录 
moveToLast() 移动 到 最 后 一 条 记录 
moveToNext() 移动 到 下 一 条 记录 
moveToPrevious() 移动 到 上 一 条 记录 
getColumnIndexOrThrow(String columnName) 根据 列 名 获得 列 索引 
getInt(int columnIndex) 根据 列 索引 获得 int 类 型 值 
getString(int columnIndex) 根据 列 索引 获得 String 类 型 值 


SQLiteOpenHelper 中 常用 的 方法 如 表 7-5 所 示 。 
表 7-5 SQLiteOpenHelper 的 常用 方法 及 说 明 


5 È 描 g 
onCreate (SQLiteDatabase db) 创建 数据 库 时 调用 
onUpgrade(SQLiteDatabase db ,int oldVersion, int newVersion) 版 本 更 新 时 调用 
getReadableDatabase() 创建 或 打开 一 个 只 读数 据 库 
getWritableDatabase () 创建 或 打开 一 个 读 写 数 据 库 


在 数据 库 第 一 次 生成 时 会 调用 onCreate() 方 法 ,一般 在 这 个 方法 里 写生 成 数据 表 的 代码 。 
当 数 据 库 需 要 升级 时 ,Android 系统 会 自动 调用 onUpgrade() 方 法 ,一 般 在 这 个 方法 里 会 删除 
数据 表 , 并 建立 新 的 数据 表 , 当然, 还 可 以 根据 应 用 的 需求 ,编写 相关 的 代码 完成 其 他 的 操作 。 


2. 相关 操作 


下 面 给 出 一 些 代码 片断 ,说 明 如 何 使 用 这 些 方法 对 数据 库 、 表 进行 操作 。 

1) 创建 数据 库 

如 果 要 在 /data/ data/ cn. com。sgmsc. ZSWB/databases 目录 下 创建 一 个 名 为 pocketblog. db 
的 数据 库 , 可 使 用 方法 : 


openOrCreateDatabase(" /data/data/cn.com. sgmsc.ZSWB/databases/pocketblog. db" , null); 


2) 创建 数据 表 

在 这 里 使 用 execSQL() 方 法 来 创建 一 个 数据 表 。 首 先 ,编写 一 条 SQL 语句 存放 到 一 个 
String 变量 中 ,然后 再 调用 execSQL() 方 法 执行 先前 编写 的 SQL 语句 。 例 如 ,创建 一 个 数据 
表 UserTb, 其 属性 列 为 : uid( 主 键 并 且 自 动 增加 )、uname( 用 户 名 ) .upsw( 密 码 ) ,可 使 用 代 
码 段 : 

String sql = "Create table UserTb(uid integer primary key autoincrement, uname text, upsw text)"; 

db. execSQL( sql); //db 是 指定 的 数据 库 对 象 

3) 插入 数据 

分 别 使 用 execSQL() 方 法 和 insert() 方 法 来 完成 向 数据 表 User Tb 插入 记录 ,以 便 读者 更 
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好 地 理解 insert() 方 法 的 使 用 。 代 码 段 如 下 : 


String sql = "insert into UserTb(uname, upsw) values('user01', '123')"; 
db.execSQL(sql); 。 // 执 行 SQL 语句, 向 db 的 数据 表 UserTb 中 插入 一 条 记录 


或 


ContentValues mycv = new ContentValues(); 


mycv. put("uname"," user01'"); 

mycv. put("upsw"," 123"); 

db. insert("UserTb", null, mycv) ; // 向 db 的 数据 表 UserTb 中 插入 一 条 记录 
4) 删除 数据 

和 插入 数据 类 似 , 使 用 两 种 方法 来 实现 删除 数据 表 User Tb 中 的 记录 。 代 码 段 如 下 : 


String sql = "delete from UserTb where uid- 2"; 
db.execSQL(sql);  //TAfT SQL 语句 ,在 db 的 数据 表 UserTb 中 删除 uid 为 2 的 记录 


或 


String whereClause = "uid = ?"; 

String[] whereArgs = (String. valueOf(2)]; 

db. delete("UserTb", whereClause, whereArgs); // 在 由 的 数据 表 UserTb 中 删除 uid 为 2 的 记录 

这 里 ,String. valueOf(2) 是 将 数值 2 转换 成 字符 串 值 “2”。String. valueOf() 是 将 其 他 基 
本 数据 类 型 转换 成 String 的 静态 方法 ,例如 : String. valueOfCint iD 将 int 变量 i 转换 成 字符 
E, String. valueOf(boolean b) 将 boolean 变量 b 转换 成 字符 串 ,String. valueOf(Cchar c) 将 
char 变量 c 转换 成 字符 串 ,等 等 。 

5) 修改 数据 

和 插入 或 删除 数据 类 似 , 使 用 两 种 方法 来 实现 修改 数据 表 UserTb 中 的 记录 。 代 码 段 
如 下 : 


String sql = "update UserTb set upsw = 666 where uid= 1"; 
db. execSQL( sql); // 执 行 SQL 语句 ,在 db 的 数据 表 UserTb 中 修改 uid 为 1 的 记录 


或 


ContentValues newvalue = new ContentValues(); 
newvalue. put("upsw"," 666"); 
String whereClause = "uid = ?"; 
String[] whereArgs = (String. valueOf(1)]; 
db. update("UserTb",newvalue, whereClause, wherehrgs); 
// 在 db 的 数据 表 UserTb 中 修改 uid Jy 1 的 记录 


6) 查询 数据 

查询 数据 方法 将 返回 一 个 Cursor 对 象 ,这 里 存放 的 是 查询 数据 表 的 结果 集 。 在 应 用 编程 
中 ,往往 要 使 用 Cursor 的 方法 ,才能 在 让 用 户 看 到 查询 结果 集中 的 内 容 。 例 如 要 查询 UserTb 
中 uid 大 于 5 的 用 户 信息 ,可 使 用 代码 段 : 

Cursor qc = db.query("UserTb" ,null, "uid >?", new String[] ( String. valueOf(5)], null, null, null); 

if(qc.moveToFirst())( // 判 断 游标 是 否 为 空 


for (int i-0; i«qc. getCount(); i++){ // 遍 历 游标 
qc. move(i); 
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Int userid = qc.getInt(0); // 获 得 用 户 id 
String username = qc. getString(1); // 获 得 用 户 名 
String userpassword- qc.getString(2); // 获 得 用 户 密码 


System. out.println(userid+ ": " + username + "," + userpassword) ; 
// 在 屏幕 上 显示 用 户 id, 用 户 名 和 密码 
i 
) 
} 
以 上 主要 是 针对 SQLiteDatabase 类 给 出 的 对 SQLite 数据 库 进行 操作 的 使 用 方法 。 在 实 
际 开 发 中 ,比较 常见 的 是 开发 一 个 数据 库 辅 助 类 来 方便 地 对 数据 库 进 行 操作 。 下 来 通过 一 个 
案例 ,来 说 明 如 何 使 用 SQLiteOpenHelper 辅助 类 来 实现 SQLite 数据 库 应 用 。 


7.8.3 SQLite 应 用 案例 


【案例 7.2】 将 “掌上 微 博 ”的 日 志 信息 存储 到 数据 库 中 。 

【说 明 】 在 第 6 章 的 案例 6.4 中 已 经 完成 了 日 志 模 块 的 用 户 界 面 设计 ,并 实现 了 日 志 列 
表 与 日 志 编辑 两 个 Activity 的 跳 转 功能 。 本 案例 以 项 目 ZSWB_Diaryl 为 基础 ,继续 完善 数据 
保存 功能 。 

本 例 使 用 SQLiteDatabase, SQLiteOpenHelper, Content Values, Cursort 来 实现 将 日 志 信 
息 保存 到 本 地 的 SQLite 数据 库 中 的 功能 。SQLiteOpenHelper 是 一 个 抽象 类 ,使 用 时 需要 创 
建 一 个 子 类 ,以 便 在 其 onCreate() 方 法 中 完成 数据 库 表 结构 的 定义 。 

【开发 步骤 及 解析 】 

CD 数据 库 设计 。“ 掌 上 微 博 "项目 中 需要 保存 到 数据 库 中 的 信息 不 少 ,在 此 只 设计 与 日 
志 相 关 的 数据 表 。 在 该 项 目 中 ,命名 数据 库 名 为 PocketBlog, 命 名 日 志 数 据 表 名 为 DiarysTb。 
数据 表 DiarysTb 的 结构 如 表 7-6 所 示 。 


表 7-6 DiarysTb 表 结构 


列 名 类 型 说 明 列 名 类 型 说 明 
d id integer Hi ID, 主 键 d_face integer 日 志 心 情 索 引 
d title varchar 日 志 标 题 d datetime datetime 写 日 志 日 期 时 间 


d_content text 日 志 内 容 d_uno varchr 日 志 所 有 者 账号 


(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ZSWB Diary2 的 Android 项 目 。 其 应 用 程序 
名 为 ZSSWB, 包 名 为 cn. com. sgmsc. ZSWB. Activity 组 件 名 为 DiaryListActivity。 

CD 准备 图 片 。 从 项 目 ZSWB_Diaryl 中 复制 图 片 资源 到 本 项 目的 res/drawable-mdpi H 
录 中 。 

(4) 准备 其 他 资源 。 从 项 目 ZSWB_Diaryl 中 复制 res/values 目录 下 colors. xml,strings. 
xml 和 styles. xml 文件 到 本 项 目的 res/values 目录 中 。 

(5) 设计 布局 。 从 项 目 ZSWB_Diaryl 中 复制 res/layout 目录 下 diarylist. xml 和 
diarydetail. xml 文件 到 本 项 目的 res/layout 目录 中 ,并 删除 main. xml 文件 。 

(6) 开发 常量 类 代码 。 从 项 目 ZSWB_Diaryl 中 复制 src/cn. com. sgmsc. ZSWB 包 下 
ContantUtil. java. DiaryListActivity. java 和 DiaryDetailActivity. java 文件 到 本 项 目的 src/ 
cn. com. sgmsc. ZSWB 包 中 。 
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CD 开发 创建 数据 库 表 代码 。 在 src/cn. com. sgmsc. ZSWB 包 下 创建 并 编写 数据 库 辅 助 
类 子 类 代码 文件 MyOpenHelper. java ,代码 如 下 所 示 。 


© 


列 名 


package cn. com. sgnsc. ZSWB; // 声 明 包 语句 


import android. content. Context; 

import android. database. sqlite. SOLiteDatabase; 

import android. database. sqlite. SOLiteOpenHelper; 

import android. database. sqlite. SQLiteDatabase. CursorFactory; 


public class MyOpenHelper extends SQLiteOpenHelper( 
public static final String DB NAME = "PocketBlog"; // 数 据 库 文件 名 称 
public static final String TABLE NAME = "DiarysTb"; // 表 名 


public static final String ID= "d id"; //1D 

public static final String TITLE - "d title"; // 日 志 标 题 

public static final String CONTENT = "d content"; // 日 志 内 容 

public static final String FACE- "d face"; // 日 志 心 情 

public static final String DATETIME = "d datetime";  // 日 志 发 布 日 期 

public static final String USERNO = "d uno"; // 日 志 所 属 用 户 ID 

// 调 用 父 类 构造 器 

public MyOpenHelper(Context context, String name, CursorFactory factory, int version) { 


super(context, name, factory, version); 


} 
@Override // 重 写 onCreate( ) 方 法 
public void onCreate(SQLiteDatabase db) { 


db. execSQL(" create table if not exists " + TABLE NAME +" ("”// 调 用 execSQL() 方 法 创建 表 
* ID * " integer primary key," 
* TITLE * " varchar," 
* CONTENT + " text," 
* FACE * " integer," 
* DATETIME * " datetime," 
* USERNO * " varchar)"); 
) 
(QOverride 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
// 重 写 onUpgrade( ) 方 法 
} 
} 
第 9 一 16 行 定义 一 些 字符 串 常量 ,分 别 用 来 表示 数据 库 名 、 数 据 表 名 以 及 表 中 的 


© 第 23 一 31 重 写 SQLiteOpenHelper 类 的 onCreate() 方 法 ,在 其 中 调用 SQLiteDatebase 
的 execSQL() 方 法 创建 数据 表 ,execSQL 内 的 参数 值 是 一 条 完整 的 创建 表 的 SQL 语句 。 这 
个 方法 在 数据 库 首 次 生成 时 自动 被 调用 。 

(8) 开发 浏览 日 志 人 代码。 修改 src/cn. com. sgmsc. ZSWB 包 下 的 代码 文件 DiaryListActivity. 
java。 增 加 的 代码 或 与 原 代码 不 同 处 使 用 粗 体 显 示 , 代 码 如 下 所 示 。 


1 
2 
3 
4 


package cn. com. sgmsc. ZSWB; 


import static cn. com. sgmsc. ZSWB. MyOpenHelper. * ; 
import android. database. Cursor; 
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import android. database. sqlite. SQLiteDatabase; 
//…… 省 略 部 分 引入 相关 类 的 代码 


public class DiaryListActivity extends Activity ( 


MyOpenHelper myHelper; // F8 RB MyOpenHelper X1 $& 

final int MENU ADD = Menu.FIRST; // 声 明 菜 单 选 行 的 ID 

final int MENU DELETE = Menu. FIRST + 1; // 声 明 菜单 项 的 编号 

final int DIALOG DELETE = 0; // 确 认 删 除 对 话 框 的 ID 

String [] diarysTitle; // 声 明 用 于 存放 日 志 标 题 的 数组 
String [] diarysDatetime; // 声 明 用 于 存放 日 志 日 期 的 数组 
int [] diarysFace; // 声 明 用 于 存放 日 志 心 情 的 数组 
int [] diarysId; // 声 明 用 于 存放 日 志 id 的 数组 
int pos= - 1; //ListView 对 象 中 的 当前 项 位 置 
ListView lv; // 声 明 ListView XI 


BaseAdapter myAdapter = new BaseAdapter()( 
//…… 省 略 构造 BaseAdapter 的 部 分 代码 
} 
}; 
View.OnClickListener listenerToEdit = new View. OnClickListener() ( 


(&Override 

public void onClick(View v) ( 
pos = v.getlId(); // Wi ListView 当前 项 的 ID 
Intent intent- new Intent(DiaryListActivity. this, DiaryDetailActivity. class); 
intent. putExtra("cmd", 0); //0 代表 查看 或 修改 日 志 ,1 代表 添加 日 志 


intent. putExtra(" id", diarysId[pos]); 
startActivity(intent); 
) 
}; 
View. OnClickListener listenerToDelete = new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
pos = v.getId(); // 取 ListView 当前 项 的 ID 
showDialog(DIALOG DELETE); // 显 示 确 认 删 除 对 话 框 ,并 实施 相应 操作 
} 
}; 
@Override 


public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. diarylist); 


myHelper = new MyOpenHelper(this, DB NAME, null, 1); // 打 开 数 据 表 库 表 


lv = (ListView)findViewById(R. id. listDiary); / [3k 18 ListView 对 象 的 引用 
lv.setAdapter(myAdapter); 
H 


(GOverride 

protected void onResume() ( 
getBasicInfo(myHelper); // 重 新 获取 数据 库 信息 
myAdapter. notifyDataSetChanged(); // 刷 新 ListView 
super. onResume( ) ; 


// 方 法 : 获取 数据 表 中 所 有 记录 部 分 列 的 数据 内 容 
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60 public void getBasicInfo(MyOpenHelper helper)( 

61 SQLiteDatabase db = helper.getWritableDatabase(); // 获 取 数 据 库 连接 

62 Cursor c = db.query(TABLE NAME, new String[ ]{ID,TITLE, DATETIME, FACE], 

63 null, null, null, null, ID); 

64 int idIndex = c.getColumnIndex(ID); 

65 int titleIndex - c.getColumnIndex(TITLE); // 获 得 标题 列 的 列 号 

66 int dtIndex = c.getColumnIndex(DATETIME); // 获 得 日 期 时 间 列 的 序号 

67 int faceIndex = c.getColumnIndex(FACE); // 获 得 心情 列 的 索引 号 

68 diarysId = new int[c.getCount()]; // 创 建 存放 id 的 int 数组 对 象 

69 diarysTitle = new String[c.getCount()]; // 创 建 存放 标题 的 String 数组 对 象 
70 diarysDatetime = new String[c.getCount()]; // 创 建 存放 日 期 时 间 的 数组 对 象 
?1 diarysFace - new int[c.getCount()]; // 创 建 存放 心情 id 的 数组 对 象 
72 int i=0; // 声 明 一 个 计数 器 

73 for(c. moveToFirst(); ! (c. isAfterLast( ) ); c. moveToNext())( 

74 diarysId[i] = c.getInt(idIndex); 

75 diarysTitle[i] = c.getString(titleIndex);  // 将 标题 添加 到 String 数组 中 

76 diarysDatetime[i] = c.getString(dtIndex); // 将 日 期 时 间 添 加 到 String 数组 中 
77 diarysFace[i] = c.getInt(faceIndex); // 将 心情 id 添加 到 String 数组 中 
78 i++; 

79 ) 

80 c.close(); // 3€ B] Cursor 对 象 

81 db. close(); //3& BH] SüLiteDatabase X $& 

82 ) 

83 

84 // 创 建 选项 菜单 

85 @Override 

86 public boolean onCreateOptionsMenu(Menu menu) { 

87 /H m 

88 ) 


89 ”// 定 义 菜单 项 被 选中 后 的 回调 事件 
90 @Override 
91 public boolean onOptionsItemSelected(MenuItem item) { 


92 Switch( item. getItemId( ) ){ // 判 断 按 下 的 菜单 选项 
93 case MENU ADD: // 按 下 了 “添加 ”菜单 
94 Intent intent = new Intent(DiaryListActivity. this, DiaryDetailActivity. class); 
95 intent. putExtra("cmd", 1); 
96 startActivity(intent); 
97 break; 
98 case MENU DELETE: // 按 下 了 “删除 ”菜单 
99 pos = DiaryListActivity. this. lv.getSelectedItemPosition( ); 
// 取 ListView 当前 项 的 ID 
100 showDialog(DIALOG DELETE); // 显 示 确 认 删 除 对 话 框 ,并 实施 相应 操作 
101 break; 
102 } 
103 return true; 
104 } 
105 


106 // 创 建 对 话 框 

107 (ZOverride 

108 protected Dialog onCreateDialog(int id) ( 

109 d ~- 

110 } 

MX 

112 // 方 法 : 删除 指定 的 日 志 记 录 

113 public void deleteDiary(int id)( //id 为 要 删除 记录 的 id 
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114 SQLiteDatabase db = myHelper.getWritableDatabase(); ”// 获 得 数据 库 对 象 
115 try{ 

116 int count = db.delete(TABLE NAME, ID+"=?", new String[](id * ""]); 

117 db. close(); 

118 if(count -- 1)( // 删 除 成 功 

119 getBasicInfo(myHelper); // 重 新 获取 数据 库 信 息 
120 myAdapter. notifyDataSetChanged(); // 刷 新 ListView 
121 } 

122 }catch(Exception e){ 

123 e. printStackTrace(); 

124 ) 

125 ] 

126 } 


O 583-5 fim f —255| AS. HEPA HP Big X938 MyOpenHelper, 

© 第 9 行 增加 了 声明 一 个 MyOpenHelper 类 对 象 myHelper。 

© 修改 了 对 BaseAdapter 中 两 个 按钮 的 监听 对 象 的 定义 。 在 定义 的 监听 对 象 
listenerToEdit 中 ,增加 了 第 26 行 获 取 ListView 当前 条 目的 ID ,增加 了 第 28,29 行为 Intent 
对 象 传 人 附加 信息 ,其 中 diarysId[pos] 是 取 日 志 在 数据 表 中 的 ID 号 ; 在 定义 的 监听 对 象 
listenerToDelete 中 ,增加 了 第 36 行 ,为 删除 表 记 录 提 供 ID 信息 。 

(D 在 onCreate() 方 法 中 增加 了 第 46 行使 用 MyOpenHelper 打开 数据 库 表 ,第 一 次 调用 
时 数据 库 表 不 存在 ,会 自动 创建 指定 名 称 的 数据 库 和 数据 表 。 

© 增加 了 第 52 一 57 行 ,定义 onResume() 方 法 , 当 Activity 与 用 户 开 始 交互 之 前 ,通过 
getBasicInfo(myHelper) 获 取 数 据 表 中 的 记录 值 ; 通过 myAdapter. notifyDataSetChanged() 
方法 刷新 屏幕 中 的 ListView 中 的 列表 信息 ,notifyDataSetChanged 是 通过 一 个 外 部 的 方法 控 
制 : 如 果 适配器 的 内 容 改 变 时 需要 强制 调用 getView() 来 刷新 每 个 Item 的 内 容 。 因 为 本 例 将 
对 数据 表 中 的 信息 做 增 、 删 改 等 操作 ,相应 地 ,屏幕 显示 也 需要 同步 更 新 。 

@ 第 60~82 行 定义 了 getBasicInfo() 方 法 。 其 中 ,第 61 行 创建 并 打开 一 个 数据 库 对 象 
db; 第 62 行 对 数据 表 的 日 志 ID, 日 志 标 题 \ 日 志 日 期 \ 日 志 心 情 图 标的 索引 进行 查询 ; 第 72 一 
79 行 遍历 该 查询 结果 游标 ,分 别 将 数据 表 的 上 述 列 中 的 值 赋予 相应 的 数组 中 ; 第 80,81 行 是 
关闭 游标 对 象 和 数据 库 对 象 。 记 住 要 养 成 一 个 好 习惯 , 当 对 数据 库 数据 表 进 行 完 操作 之 后 要 
即时 关闭 之 。 

CD 增加 了 第 95 行 , 当 单 击 了 “添加 ”菜单 项 时 ,将 一 个 状态 附加 信息 传人 到 Intent 对 
象 中 。 

(& 第 113 一 125 行 定义 了 deleteDiary() 方 法 。 其 中 ,第 116 行使 用 delete() 方 法 删除 数据 
表 中 的 指定 ID 的 记录 ,并 将 返回 删除 操作 执行 的 状态 值 , 当 其 返回 为 1 时 表示 删除 成 功 ,否则 
删除 失败 ; 第 118 一 124 行 是 对 删除 成 功 后 所 做 的 系列 处 理 : 重新 获取 数据 表 的 数据 集 ,更 新 
屏幕 的 日 志 列表 。 

(9) 开发 编辑 日 志 代 码 。 修 改 src/cn. com. sgmsc. ZSWB 包 下 的 代码 文件 DiaryDetailActivity. 
java。 增 加 的 代码 或 与 原 代 码 不 同 处 使 用 粗 体 显示 ,代码 如 下 所 示 。 


package cn. com. sgnsc. ZSWB; 


import static cn. com. sgmsc. ZSWB. MyOpenHelper. * ; 
import android. content.ContentValues; 
import android. text. format. DateFormat; 


up wm 
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6 import android. database. Cursor; 

"7 import android. database. sqlite. SQüLiteDatabase; 
8 //…… 省 略 部 分 引入 相关 类 的 代码 

9 


10 public class DiaryDetailActivity extends Activity{ 


11  EditText etModifyTitle = null; // 显 示 日 志 标 题 的 EditText 

12 EditText etModifyContent - null; // 显 示 日 志 内 容 的 EditText 

13 TextView tvdttm = null; // 显 示 日 志 创建 时 间 的 TextView 
14 Spinner facesp = null; // 显 示 心 情 的 Spinner 

15 int status = -1; //0 表示 查看 或 修改 日 志 ,1 表示 添加 日 志 
16 MyOpenHelper nyHelper; // 声 明 一 个 MyOpenHelper 对 象 
17 intid = -1; // 记 录 当 前 显示 的 日 志 id 

18 String [] diaryInfo = null; // 记 录 日 志 信息 

19 int faceselectedid= - 1; // 心 情 的 这 号 

20 DateFormat df = null; // 显 示 日 期 时 间 的 格式 

21 

22 (2 Override 

23 protected void onCreate(Bundle savedInstanceState) { 

24 super. onCreate(savedInstanceState); 

25 setContentView(R. layout.diarydetail); 

26 

27 //…… 省 略 部 分 代码 

28 facesp. setOnItemSelectedListener( // 设 置 选 项 选中 的 监听 器 

29 new OnItemSelectedListener()( 

30 @Override 

31 public void onItemSelected(AdapterView <?> arg0, View argl, 

32 int arg2, long arg3) ( // 重 写 选 项 被 选中 事件 的 处 理 方法 
33 faceselectedid = arg2; 

34 } 

35 @Override 

36 public void onNothingSelected(RdapterView <?> arg0) {} 

37 } 

38 m 

39 

40 myHelper - new MyOpenHelper(this, MyOpenHelper.DB NAME, null, 1); 

41 Intent intent = getIntent(); 

42 status = intent.getExtras().getInt(" cmd" );// 读 取 命令 类 型 

43 

44 switch(status)( 

45 case 0: // 查 看 或 修改 日 志 的 详细 信息 
46 id = intent.getExtras().getInt("id"); // 获 得 要 显示 的 日 志 的 id 

47 SQLiteDatabase db = myHelper.getWritableDatabase(); 

48 Cursor c = db.query(MyOpenHelper. TABLE NAME, 

49 new String[](TITLE, CONTENT, FACE, DATETIME, USERNO) , 
50 IDt"-?", 

51 new String[](id * ""), null, null, null); 

52 if(c.getCount() == 0){ // 没 有 查询 到 指定 的 日 志 

53 // 显 示 没 有 找到 指定 的 日 志 信 息 
54 ) 

55 else( // 查 询 到 了 这 条 日 志 

56 c. moveToFirst(); // 移 动 到 第 一 条 记录 

57 etModifyTitle. setText(c.getString(0)); 

58 etModifyContent. setText(c. getString(1)); 

59 facesp. setSelection(c.getInt(2), true); // 设 置 指定 的 心情 图 标 项 


60 tvdttm. setText(c.getString(3)); 
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61 } 
62 c.close(); 
63 db. close(); 
64 break; 
65 case 1: // 新 建 日 志 的 详细 信息 
66 etModifyTitle.getEditableText().clear(); / [18 8 EditText 项 
67 etModifyContent.getEditableText().clear(); 
68 facesp. setSelection(0, true); // 将 心情 设置 为 第 一 个 图 标 项 
69 break; 
70 ) 
71 
72 Button btnModifyDiary = (Button)findViewById(R. id.btnModifyDiary); 
// 获 得 “发 布 日 志 ” 按 钮 
73 btnModifyDiary. setOnClickListener(new View. OnClickListener() { 
74 @Override 
75 public void onClick(View v) { 
76 String modifyTitle = etModifyTitle.getEditableText().toString().trim(); 
77 // 取 出 EditText 中 标题 的 内 容 
78 String modifyContent = etModifyContent. getEditableText(). toString().trin(); 
79 if(modifyContent.equals("") || nodifyTitle.equals(""))( 
// 如 果 标 题 或 内 容 为 空 则 提示 
80 // 提 示 需 要 将 标题 或 内 容 填 写 完 整 
81 return; 
82 ) 
83 df = new android. text.format.DateFormat();// 定 义 一 个 日 期 格式 对 象 
84 tvdttm. setText (df. format(" yyyy - MM - dd hh:mm: ss", new java. util.Date())); 
// 取 当前 的 日 期 
85 switch(status)( // 判 断 当前 的 状态 
86 case 0: // 编 辑 或 查看 已 有 日 志 时 
87 updateDiary(); // 调 用 更 新 日 志方 法 
88 break; 
89 case 1: // 新 建 日 志 时 
90 insertDiary(); // 调 用 插入 日 志方 法 
91 break; 
92 ) 
93 // 返 回 到 日 志 列表 Activity 
94 Intent intent = new Intent(DiaryDetailActivity. this, DiaryListActivity.class); 
95 intent.putExtra(" id", id); 
96 startActivity(intent); 
97 ) 
98 »r 
99 Button btnModifyBack - (Button)findViewById(R. id. btnModifyDiaryBack); 
// 获 得 “返回 "按钮 
100 btnModifyBack. setOnClickListener(new View. OnClickListener() { 
101 @Override 
102 public void onClick(View v) { 
103 Intent intent = new Intent(DiaryDetailActivity. this, DiaryListActivity. class); 
104 intent. putExtra(" id", id); 
105 startActivity(intent); 
106 } 
107 DE 
108 } 
109 


110 // 方 法 : 更 新 某 个 日 志 
111 public void updateDiary()( 
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112 SQLiteDatabase db = myHelper. getWritableDatabase( ); // 获 得 数据 库 对 象 
113 ContentValues values = new ContentValues(); 

114 values.put(TITLE, etModifyTitle.getText().toString()); 

115 values.put(CONTENT, etModifyContent.getText(). toString()); 

116 values.put(FACE, faceselectedid); 

117 values.put(DATETIME, tvdttm. getText(). toString()); 

118 db.update(TABLE NAME, values, ID* " = ?", new String[](id * ")); // 更 新 数据 库 

119 db. close(); 

120 } 

121 


122 // 方 法 : 添加 日 志 
123 public void insertDiary()( 


124 SQLiteDatabase db = myHelper.getWritableDatabase(); // 获 得 数据 库 对 象 
125 ContentValues values = new ContentValues(); 

126 values. put (TITLE, etModifyTitle.getText().toString()); 

127 values.put(CONTENT, etModifyContent.getText().toString(ry); 

128 values. put (FACE, faceselectedid); 

129 values. put(DATETIME, tvdttm.getText().toString()); 

130 db.insert(TABLE NAME, ID, values); // 插 入 数据 

131 db.close(); 

132 } 

133 ) 


CD 增加 了 第 33 行 一 条 赋值 语句 ,在 心情 图 标 Spinner 控件 的 Adapter 监听 器 中 ,获取 选 
中 的 索引 号 。 

© 第 40 行 创建 一 个 SQLiteOpenHelper 对 象 ,打开 数据 库 表 。 

© 第 42 行 获得 Intent 对 象 的 附加 信息 cmd 的 值 并 赋 给 变量 status ,确定 用 户 发 出 的 是 
编辑 还 是 新 增 数据 表 记 录 。 第 45 一 64 行 定 义 查 看 或 修改 日 志 的 代码 , 当 status 值 为 0 时 ,第 
46 行 获得 用 户 选 中 的 记录 ID 号 ,第 48 一 51 行 执行 对 数据 表 的 每 一 列 , 日 志 ID 号 为 用 户 所 选 
ID 记录 的 查询 ; 如 果 找 到 需要 的 日 志 , 在 第 56 一 60 行 从 数据 表 中 取出 相应 信息 显示 在 屏幕 
的 对 应 控件 中 ; 第 62,63 行 关闭 游标 和 数据 库 。 当 status 值 为 1 时 ,清空 屏幕 上 的 用 于 显示 
日 志 标 题 .日志 日 期 和 日 志 内 容 等 控件 ,心情 图 标 默 认为 第 一 个 ,为 新 增 一 条 日 志 作 准 备 。 

(D 第 73 一 98 行 定义 “发 布 日 志 ? 按 钮 的 监听 。 在 其 中 ,第 79 行 检查 日 志 的 标题 编辑 框 和 
内 容 编辑 框 内 容 是 否 有 为 空 的 ,如 果 有 一 个 为 空 , 用 户 必 须 回去 填写 ; 第 84 行 按 指定 的 格式 
获得 系统 当前 的 日 期 时 间 值 ; 第 85 一 92 行 根据 status 值 ,分 别 调用 自 定义 方法 updateDiary OI 
insertDiary() 。 

© 55 111—120 行 定义 了 updateDiary ) 方 法 ,其 中 第 118 行 调用 SQLiteDatebase 的 
update() 方 法 修改 指定 ID 的 记录 内 容 。 

© 第 123 一 132 行 定义 了 insertDiary( ) 方 法 ,其 中 第 130 行 调用 SQLiteDatebase 的 
insert() 方 法 添加 一 条 新 记录 内 容 。 

CD 在 定义 “返回 ?按钮 的 监听 中 ,增加 了 第 104 行 ,将 当前 日 志 的 ID 号 附加 到 返回 的 
Intent 中 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 KDWB_Diary2 项 目 。 按 下 手 
机 (或 模拟 器 ) 中 的 menu 键 , 调 出 选项 菜单 ,如 图 7-4 所 示 。 当 单 击 “ 添 加 ”菜单 项 ,进入 日 志 
编辑 窗口 进行 添加 新 日 志 操 作 , 完 成 后 可 单 击 “ 发 布 日 志 ” 按 钮 ,将 录入 的 新 日 志 信 息 保 存 到 数 
据 库 表 中 并 返回 到 日 志 列 表 窗 口 ,如 图 7-5 所 示 。 
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图 7-4 调 出 选项 菜单 界面 图 7-5 日 志 录入 编辑 界面 


到 此 为 止 ,本 童 所 介绍 的 应 用 程序 数据 存储 方式 ,无 论 是 使 用 配置 文件 .文件 存储 还 是 数 
据 库存 储 ,数据 是 应 用 程序 私有 的 。 在 Android 系统 中 ,没有 一 个 公共 的 内 存 区 域 , 供 多 个 应 
用 共享 存储 数据 ,所 以 应 用 程序 之 间 是 相互 独立 的 ,它们 分 别 运行 在 自己 的 进程 中 。 而 
ContentProvider 机 制 可 以 支持 在 多 个 应 用 程序 中 存储 和 读 取 数 据 ,这 个 组 件 是 解决 跨 应 用 共 
享 数据 的 唯一 方式 。 


G. 4 ContentProvider 


ContentProvider 是 所 有 应 用 程序 之 间 数 据 存储 和 检索 的 桥梁 , 它 的 作用 就 是 使 得 各 个 应 
用 程序 之 间 实 现 数据 共享 。 在 Android 中 ,ContentProvider 是 一 种 特殊 的 存储 数据 的 类 型 ， 
它 提供 了 一 套 标准 的 接口 用 来 获取 、 操 作 数 据 。 例 如 音频 、 视 频 、 图 片 和 个 人 联系 信息 等 几 种 
常用 的 ContentProvider。 它 们 被 定义 在 android. provider 包 下 。 通 过 这 些 定 义 好 的 
ContentProvider 可 以 方便 地 进行 数据 读 取 , 也 可 以 进行 数据 删除 等 操作 。 当 然 ,执行 这 些 操 
作 必 须 拥 有 适当 的 权限 , 记 住 ,要 在 应 用 项 目的 AndroidManifest. xml 中 把 相关 权限 添加 
进去 。 


7.4.1 实现 数据 共享 的 相关 类 接口 与 权限 


1. ContentProvider 


ContentProvider 类 位 于 android. content 包 下 。 一 个 程序 可 以 通过 实 -个 
ContentProvider 的 抽象 方法 接口 将 自己 的 数据 暴露 出 去 ,外 部 程序 可 以 通过 picto H 
来 和 本 程序 内 的 数据 打交道 。 所 以 定义 一 个 ContentProvider 必须 要 实现 几 个 抽象 方法 接口 ， 

些 常用 抽象 方法 如 表 7-7 所 示 。 
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表 7-7 ContentProvider 的 常用 抽象 方法 及 说 明 
方 法 do 述 


query(Uri uri, String[] projection. String selection, 通过 URI 进行 查询 ,返回 一 个 Cursor 
String[] selectionArgs，String sortOrder) 

insertCUri uri, ContentValues values) 将 一 组 数据 插入 到 URI 指定 的 地 方 

delete( Uri uri, String where，String[] selectionArgs) 删除 指定 URI 并且 符 合 一 定 条 件 的 数据 
update(Uri uri，ContentValues values，String where， 更 新 URI 指定 位 置 并 且 符 合 一 定 条 件 的 数据 
String[] selectionArgs ) 


getType(Uri uri) 获得 MIME 数据 类 型 
onCreate() 当 ContentProvider 创建 时 调用 
getContext() 获得 Context 对 象 


在 上 述 方法 中 使 用 最 多 的 是 query() 方 法 ,下 面 对 其 参数 进行 说 明 。 

名 参数 uri 为 指定 的 URI 地 址 。 

e £t projection 为 指定 的 返回 列 名 。 

名 参数 selection 用 于 指定 返回 的 行 ,相当 于 SQL 语句 中 的 WHERE 子 句 。 
局 参数 selectionArgs 对 参数 selection 中 出 现 的 “?” 进 行 替换 。 

4 2t sortOrder 指定 返回 结果 的 排序 方式 。 


2. ContentResolve 


ContentResolve 类 位 于 android. content 包 下 。 当 外 部 应 用 程序 需要 对 ContentProvider 
中 的 数据 进行 添加 .删除 .修改 和 查询 操作 时 ,可 以 使 用 ContentResolver 接口 来 完成 ,在 
Activity 中 通过 getContentResolver () 7j i 3K Ht ContentResolver 对 象 。ContentResolver 提 
供 的 抽象 方法 与 ContentProvider 需要 实现 的 方法 对 应 ,同样 使 用 query O ,insertO ,deleteO , 
update() 等 方法 来 操作 数据 。 这 些 方法 的 名 称 和 参数 与 ContentProvider 中 的 一 样 ,在 此 不 作 
JOE. 

一 般 情况 下 ,ContentProvider 是 单 实例 的 ,但 是 可 以 有 多 个 ContentResolve 在 不 同 的 应 
用 程序 和 不 同 的 进程 之 间 和 ContentProvider 交互 。 


3. URI 


URI 是 指向 数据 的 一 个 资源 标识 符 。 通 过 URI 使 得 ContentResolve 知道 与 哪 一 个 
ContentProvider 对 应 ,并 且 来 操作 哪些 数据 。 在 ContentProvider 和 ContentResolve 中 URI 
通常 有 两 种 形式 ,一 种 是 指定 全 部 数据 , 另 一 种 是 指定 某 个 ID 数据 。 例 如 : 

1) 指定 全 部 的 联系 人 数据 


content: //contacts/people/ 
2) 指定 ID 为 2 的 联系 人 数据 
content://contacts/people/2 


通常 URI 比较 长 ,在 编程 时 容易 出 错 , 且 难以 理解 。 所 以 在 Android 中 定义 了 一 些 辅助 
类 ,在 其 中 定义 了 一 些 常 量 来 代替 这 些 长 字符 串 的 URL 
例如 ,在 定义 ContentProvider 接口 的 代码 文件 DiaryContentProvider. java 中 定义 : 
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public static final Uri CONTENT URI = Uri.parse("content://" + AUTHORITY + "/diaries"); 


此 后 CONTENT URI fH 4 T "content: //cn. com. sgmsc. ZSWB. DiaryContentProvider/ 


diaries" 。 
4. 设置 权限 


需要 注意 的 是 ,无 论 对 哪 一 个 ContentProvider 中 的 数据 进行 操作 ,进行 哪 一 类 操作 ,都 需 
要 在 AndroidManifest. xml 文件 中 添加 相应 的 权限 。 例 如 要 对 手机 的 通讯 录 进行 查询 和 修改 
操作 , 则 在 AndroidManifest. xml 文件 的 二 manifest 二 标签 内 需要 添加 下 列 权限 设 置 : 


<uses - permission android:name = "android. permission. READ CONTACTS" /> 
« uses - permission android:name - "android. permission. WRITE CONTACTS" /» 


7.4.2 ContentProvider 应 用 案例 


下 面 通过 一 个 简单 案例 来 说 明 ContentProvider 如 何 实现 应 用 程序 之 间 的 数据 共享 。 

【案例 7.3】 自 定义 一 个 Activity, 用 于 查看 手机 通讯 录 中 的 信息 。 

[8] 每 一 个 手机 都 定制 有 通讯 录 管 理应 用 程序 。 在 SDK 2.3 以 前 的 版 本 中 ,这 个 应 
用 程序 定义 于 android. provider. Contacts. Phones 类 中 ,系统 定义 Phones. CONTENT, URI 
常量 来 表示 通讯 录 的 数据 URI。 在 SDK 2. 3 以 后 的 版 本 中 ,该 应 用 程序 定义 于 android. 
provider. ContactsContract 类 中 ,系统 定义 ContactsContract. CommonDataKinds. Phone. 
CONTENT_URI 常量 来 表示 通讯 录 数 据 的 URI。 

本 例 将 使 用 SimpleCursorAdapter 为 ListView 绑 定数 据 。SimpleCursorAdapter 中 的 数 
据 取 自 于 一 个 游标 对 象 。 

【开发 步骤 及 解析 】 

(OD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ContentProvider 的 Android 项 目 。 其 应 用 程 
序 名 为 ContentPrd, 包 名 为 cn. com. sgmsc. CP, Activity 组 件 名 为 ContentPrdActivity , 

(2) 开发 逻辑 代码 。 本 例 不 修改 项 目 创建 时 生成 的 布局 文件 main. xml, Hf Java 代码 文 
件 作 修改 。 编 辑 src/cn. com. sgmsc. CP 包 下 的 ContentPrdActivity. java, 代 码 如 下 所 示 。 


package cn. com. sgmsc. CP; 


a 

2 

3 import android. app. ListActivity; 

4 import android. database. Cursor; 

5 import android. os. Bundle; 

6 import android. content. ContentResolver; 

7 import android. provider.ContactsContract; 
8 import android. widget. ListAdapter; 

9 import android. widget. SimpleCursorAdapter; 


10 

11 public class ContentPrdActivity extends ListActivity { 

12 

13 protected void onCreate(Bundle savedInstanceState) { 
14 super. onCreate(savedInstanceState); 

15 


16 ContentResolver cr = getContentResolver(); 
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17 Cursor c = cr. query(ContactsContract. CommonDataKinds. Phone. CONTENT URI, null, null, 
null, null); 

18 startManagingCursor(c) ; 

19 ListAdapter adapter = new SimpleCursorAdapter(this, 

20 android.R.layout.simple list item 2, c, 

21 new String[ ] ( ContactsContract. CommonDataKinds.Phone. DISPLAY NAME, 

22 ContactsContract. CommonDataKinds. Phone. NUMBER ), 

23 new int[] ( android.R. id.textl, android.R. id.text2 ]); 

24 setListAdapter(adapter); 

25 ) 

26 

22.) 


(D ContentPrdActivity 是 继承 ListActivity 类 ,所 以 在 第 3 行 引 入 android. app. 
ListActivity 类。 

© 第 16 行 ,使 用 getContentResolver() 方 法 得 到 一 个 ContentResolver 实例 cr。 

© 第 17 行使 用 cr. query() 查 询 手 机 通讯 录 中 所 有 联系 人 信息 ,并 返回 到 一 个 Cursor 对 
象 c 中 。 其 中 ContactsContract. CommonDataKinds. Phone. CONTENT. URI 是 指向 全 体 联 
系 人 的 URI。 

@ 第 18 行 ,startManagingCursor(c) 语 句 是 让 系统 来 管理 生成 的 Cursor。 

© 第 19 一 23 行 ,ListAdapter adapter = new SimpleCursorAdapter(…) 是 从 Cursor 对 
象 c 中 取出 数据 生成 一 个 ListAdapter 适配器 对 象 adapter。 其 中 第 一 个 参数 this 表示 当前 上 
下 文 的 引用 ; 第 二 个 参数 android. R. layout. simple_list_item_2 ,表示 这 个 ListAdapter 每 一 
个 条 目的 显示 布局 由 系统 定义 的 布局 文件 确定 ; 第 三 个 参数 c 表示 数据 集 来 源 于 Cursor 对 象 
c: 第 四 个 参数 是 一 个 String 数组 : new String[] {…. DISPLAY NAME, … NUMBER }, 
其 中 ContactsContract. CommonDataKinds. Phone. DISPLAY NAME 用 于 从 通讯 录 中 的 联 
系 人 姓名 列 中 取 值 ,ContactsContract. CommonDataKinds. Phone. NUMBER 用 于 从 通讯 录 
中 的 联系 人 电话 号 码 列 中 取 值 ; 第 五 个 参数 是 一 个 int 数组 : new int[] { android. R. id. 
textl, android. R. id. text2 ) ,该 数组 的 值 是 android. R. layout. simple_list_item_2 中 定义 的 
两 个 TextView 的 ID。 

© 第 24 行 ,setLiAdapter(adapter) 将 List View 和 SimpleCursorAdapter 进行 绑 定 ,并 显 
示 出 来 。 

(3) 编辑 AndroidManifest. xml 文件 。 修 改 项 目 根 目录 下 的 AndroidManifest. xml 文件 ， 
添加 相应 权限 ,代码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 


2 «manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
3 package = "cn. com. sgmsc. CP" 


4 android: versionCode = "1" 

5 android:versionName - "1.0" » 

6 

Ei < uses - sdk android:minSdkVersion- "10" /> 

8 < uses - permission android:name = "android. permission. READ CONTACTS" /> 
9 

10 «application 

11 android: icon = "@drawable/ic_launcher" 


12 android: label = "@string/app_name" > 
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13 <activity 

14 android: label = "@string/app_name" 

15 android:name = ". ContentPrdActivity" > 

16 < intent - filter > 

17 <action android:name = "android. intent. action. MAIN" /> 
18 

19 < category android:name = "android. intent. category. LAUNCHER" /> 
20 </intent - filter > 

21 </activity> 

22 «/application» 

23 


24 </manifest > 


第 8 行 , 添 加 对 手机 通讯 录 数 据 的 可 读 权限 。 

【运行 结果 】 如 果 你 的 手机 或 模拟 器 的 通讯 录 中 没有 任何 联系 人 信息 ,请 先 向 通讯 录 中 
添加 若干 个 联系 人 。 其 操作 步骤 如 下 。 

CD. 按 手 机 (或 模拟 器 ) 中 的 Home 键 ,找到 桌面 中 的 Contacts 应 用 程序 ,如 图 7-6 所 示 。 

(2) 单 击 Contacts 进入 应 用 程序 ,然后 按 下 手机 (或 模拟 器 ) 中 的 menu 键 ,在 选项 菜单 中 


选择 New contact 菜单 项 ,对 联系 人 姓名 、 电 话 号 码 等 信息 


息 进行 添加 。 


(3) 重复 第 (2) 步 多 添加 几 个 联系 人 ,如 图 7-7 所 示 。 然 后 退出 Contacts 应 用 。 
现在 可 以 运行 本 案例 了 ,运行 ContentProvider 项 目 , 即 可 在 屏幕 上 看 到 通讯 录 中 的 信息 ， 


如 图 7-8 所 示 。 
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图 7-6 模拟 器 桌面 中 的 应 用 程序 


7.5 访问 SD 卡 简介 
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图 7-7 


Contacts 应 用 程序 的 图 7-8 在 ContentProvider 中 
联系 人 列表 看 到 联系 人 信息 


手机 除了 本 机 内 存 外 ,还 可 以 使 用 SD 卡 来 扩展 存储 空间 。SD 卡 (Secure Digital Memory 
Card ,安全 数码 卡 ) 是 一 种 基于 半导体 快 闪 记忆 器 的 新 一 代 记忆 便携 式 设 备 ,拥有 高 记忆 容量 、 
速 数据 传输 率 、 极 大 的 移动 灵活 性 以 及 很 好 的 安全 性 。 目 前 Android 支持 8MB— 128GB 的 


快 
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SDF. 

在 使 用 模拟 器 开发 时 ,可 以 通过 硬盘 来 模拟 SD 卡 。 模 拟 SD 卡 的 步骤 是 : 第 一 步 创 建 一 
个 SD 卡 镜像 文件 ; 第 二 步 关联 SD 卡 和 模拟 器 ; 第 三 步 向 SD 卡 中 导入 文件 ; 最 后 是 在 模拟 
器 中 使 用 SD 卡 中 的 文件 。 下 面 对 每 一 步骤 作 详细 介绍 。 


1. 创建 一 个 SD 卡 镜像 文件 


创建 SD 卡 是 在 命令 提示 符 状态 下 完成 的 。 创 建 SD 卡 的 命令 文件 名 为 mksdcard. exe. 
存放 在 Android SDK 的 安装 文件 夹 的 tools 子 文件 夹 下 ,例如 在 本 书 中 ,创建 SD 卡 命令 
mksdcard. exe 位 于 E:Nandroid-sdk \tools 文件 夹 下 。 为 了 避免 运行 此 文件 时 需要 输入 一 长 
串 的 路 径 ,建议 先 设 置 Windows 操作 系统 的 环境 参数 path, 在 path 中 添加 设置 sdk 文件 夹 下 
的 tools 文件 夹 路 径 ( 如 果 是 Android 3. 0 还 要 设置 platform-tools 文件 夹 路 径 ) 。 注 意 , 本 书 
后 续 章 节 都 是 在 设置 了 该 路 径 的 环境 下 进行 阐述 ,使 用 时 不 再 提 及 。 在 做 好 上 述 系 统 环境 参 
数 设置 后 ,就 可 以 按 如 下 步骤 创建 SD 卡 镜像 文件 了 。 

(1) 运行 cmd 命令 ,进入 DOS 命令 行 提 示 状 态 。 

(2) 确定 存放 SD 卡 镜像 文件 存放 位 置 ( 用 DOS 命令 进入 存放 镜像 文件 的 子 目录 中 )。 例 
如 ,在 DOS 命令 符 状态 下 输入 DOS 命令 “CD C:\ Users\compaq\. android\avd”。 注 意 ， 
mksdcard 命令 不 会 自动 建立 不 存在 的 文件 夹 ,因此 ,在 执行 上 面 命 令 之 前 要 确认 指定 文件 夹 
已 存在 ,否则 先 创建 之 。 

(3) 输入 如 下 DOS 命令 “mksdcard 1024M sdcard. img”。 其 中 ,mksdcard 是 创建 命令 ; 
1024M 是 SD 卡 容量 , 即 为 1GB, 这 里 的 单位 为 K、M( 必 须 大 写 ); sdcard. img 是 SD 卡 镜像 文 
件 名 ,在 当前 文件 夹 中 (可 以 指定 路 径 )。 

(4) 完成 上 述 操 作 后 就 可 以 在 指定 文件 夹 下 看 到 刚 建立 的 sdcard. img 文件 了 。 


2. 关联 SD 卡 和 模拟 器 


关联 SD 卡 和 模拟 器 实际 上 是 让 模拟 器 知道 它 的 SD 卡 镜像 文件 存储 的 路 径 。 这 个 关联 
操作 可 使 用 三 种 方式 ,第 一 种 是 在 DOS 命令 行 提示 状态 下 使 用 命令 方式 ,另外 两 种 是 在 
Eclipse 中 使 用 菜单 进行 可 视 化 设置 。 下 面 分 别 介绍 。 

1) 方式 一 

运行 cmd 命令 ,进入 DOS 命令 行 提 示 状 态 ,输入 命令 : 


emulator - avd AVD and- 23 - sdcard c:\users\compaq\. android\avd\sdcard. img 


该 命令 可 启动 Eclipse 的 AVD, 并 自动 为 其 绑 定 指定 的 SD 卡 。 其 中 “AVD_and-23” 是 模 
拟 器 的 名 称 ,“c:\users\compaq\. android\avd\sdcard. img” 是 SD 镜像 文件 的 全 路 径 文件 名 。 

2) 方式 二 

(1) 打开 Eclipse, 选 择 菜单 Run— Run Configurations... ,进入 Run Configurations 窗口 。 

(2) 在 右边 窗口 的 选项 卡 中 选择 Target, 如果 有 多 个 模拟 器 ,请 在 Select a preferred 
Androd Virtual Device for deployment 复 选 框 中 选择 需要 的 模拟 器 。 

(3) Æ Target 选项 页 下 方 的 Additional Emulator Command Line Options 的 编辑 框 中 输 
入“-sdcard c:\users\compaq\. android\avd\ sdcard. img”, 这 就 是 模拟 器 启动 时 的 参数 ,如 
图 7-9 所 示 。 
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EE EE 2 Name: AudioPlay 
[ppeierot e C Common] 
Android Application ~ E 
E 20Graphics. 
3DCube 1 Refresh 
E 3DCube 2 
3DCube 3 ge- 
Tr 3DGraphics. Emulator launch parameters: 
T AudioPlay. Network Speed: (full... 
FrameAnimation. 
E Graphics Network Latency: [None. x] 
E KDWB-Android2 El Wipe User Data 
四 photoCaptureExan E Disable Boot Animation 
Sample 13.5 Additional Emulator Command Line Options 
E Sample 2 10 |-sdcard cXusersvcompaqy android Vavdsdcard img ] 
Sample 211 ~ 一 
*—  ， 
Fiter matched 54 of 60 items (ae) Lren] | 
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(4) 单 击 Apply 按钮 即 完成 设置 。 

3) 方式 三 

(1) 打开 Eclipse, 选 择 菜单 Window-* Preferences 3E A. Preferences 窗口 。 

(2) 在 type filter text 中 选择 Android->Launch ,在 右边 的 Default emulator options 的 编 
辑 框 中 输入 “-sdcard c:\users\compaq\. android VavdNsdcard. img”, 设 置 模拟 器 默认 的 启动 参 
数 ,如 图 7-10 所 示 。 

(3) 单 击 Apply 按钮 即 完成 设置 。 


W Preferences» 0o one -* 


| [type filter text Launch TTEN 
^. | Launch Settings: 
Default emulator options: -sdcard c\users\compaq\android\avd\sdcard.img| 


DDMS | | Default HOME package: — android process .acore 
Editors. | 
Launch | 


图 7-10 设置 模拟 器 的 默认 启动 参数 


3. 向 SD 卡 导 入 文件 


初始 创建 的 SD 卡 内 没有 任何 文件 ,需要 向 其 内 装载 文件 。 可 以 按 如 下 步骤 向 SD 卡 镜像 
文件 中 装载 文件 。 

(1) 在 Eclipse 中 启动 模拟 器 。 

(2) 向 SD 卡 镜像 文件 中 装载 文件 。 有 两 种 方式 向 SD 卡 导 入 文件 ,一 种 是 在 DOS 命令 
行 提示 状态 下 使 用 命令 方式 , 另 一 种 是 在 Eclipse 中 使 用 菜单 进行 可 视 化 设置 。 下 面 分 别 
介绍 。 

@ 方式 一 。 

运行 cmd 命令 ,进入 DOS 命令 行 提示 状态 ,输入 命令 .: 

adb push e:\3gms\music02. mp3 /sdcard/music. mp3 


该 命令 将 指定 目录 下 的 music02. mp3 音频 文件 导入 到 名 为 sdcard. img 的 镜像 文件 中 , 即 
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导入 到 了 SD 卡 中。 注意 ,sdcard. img 可 以 不 在 音频 文件 的 文件 夹 中 。 这 里 ,music02. mp3 X 
件 是 在 e:\3gms 文件 夹 中 ,而 sdcard. img 则 在 c:\users\compaq\. android\avd 文件 夹 中 , 导 
入 到 SD 卡 中 的 文件 名 为 music. mp3。 

Q 方式 二 。 

ft Eclipse 中 ,打开 DDMS 的 FileExplorer 选项 卡 。 

局 选择 sdcard, 单 击 右 上 角 的 push 按钮 别 , 打 开 Put File on Device 窗口 ,选择 要 导入 的 

文件 ,然后 单 击 “ 打 开 ” 按 钮 ,将 文件 导入 进来 。 
S AJ B RETE sdcard 目录 下 看 到 刚 导 入 的 文件 ,如 图 7-11 所 示 。 


38, Threads | @ Allocation Tracker @ Heap [Hle Explorer i. Wai---c 
Name Size Date Time Permissions info 
B data 2011-04-14 10:10 
© mnt 2011-05-05 14:25 
© asec 2011-05-05 14:25 
© obb 2011-05-05 1425 
© sdcard 2011-05-05 14:29 
BB LOST.DIR 2011-04-12 02:33 
局 musicmp3 1278352 2011-05-04 09:18 
© secure 2011-05-05 14:25 
© system 2011-01-20 00:51 drwxr-xr-x 


7-11 在 DDMS 的 File Explorer 中 查看 SD 卡 中 的 文件 


4. 使 用 SD 卡 中 的 文件 


在 向 SD 卡 中 导入 了 文件 之 后 ,在 应 用 程序 中 就 可 以 使 用 这 些 文件 了 。 例 如 ,向 SD 卡 中 
导入 了 一 个 音频 文件 music. mp3 ,可 以 在 代码 文件 中 编写 如 下 代码 。 


import android. media. MediaPlayer; // 引 入 媒体 播放 器 类 

MediaPlayer mp = new MediaPlayer(); // 创 建 一 个 MediaPlayer 对 象 mp 

try{ 
mp. setDataSource("/sdcard/music. mp3") ; // 设 置 音乐 文件 取 自 于 SD 卡 中 的 music. mp3 
np. prepare() ; 
mp. start(); // 播 放 音 乐 


i 
catch(Exception e)( 
e. printStackTrace(); 


本 章 重点 介绍 了 应 用 程序 的 数据 的 SharedPreferences 存 取 和 SQLite 数据 库 操 作 的 方法 
技术 ,还 介绍 了 应 用 程序 之 间 的 数据 共享 技术 ContentProvider 和 使 用 SD Card 存 取 文件 的 方 
法 步骤 。 掌 握 了 这 些 数据 存储 技术 和 数据 共享 技术 ,加 之 Java 的 文件 读 写 处 理 技术 ,要 开发 
一 个 Android 的 本 地 应 用 就 会 毫 无 问题 。 

在 介绍 SQLite 数据 库 操作 时 涉及 数据 库 的 数据 描述 语言 DDL 和 数据 操纵 语言 DML fH 
关内 容 , 这 些 也 是 开发 应 用 程序 时 必 备 的 数据 库 技术 。 

为 了 让 用 户 界面 更 炫 更 精彩 ,为 了 让 用 户 能 更 好 地 体验 应 用 程序 的 操作 使 用 ,可 以 向 应 用 
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程序 中 加 入 更 多 的 表现 形式 ,如 在 应 用 中 添加 一 段 音乐 .插入 一 个 视频 等 。 第 8 章 将 介绍 
Android 的 多 媒体 应 用 开发 。 


练习 
设计 “掌上 微 博 ”的 联系 人 查看 及 好 友 保 存 模块 ,要 求 至 少 使 用 两 个 Activity, 一 个 


Activity 用 于 列表 显示 好 友 名 单 , 男 一 个 Activity 是 显示 选 定好 友 的 详细 信息 ,并 保存 到 本 地 
数据 库 中 。 


多 媒体 应 用 开发 | 


多 媒体 的 应 用 是 现今 应 用 项 目 中 不 可 缺少 的 增值 亮点 。 在 前 面 的 童 节 中 ,已 经 学 习 了 
对 于 文本 、 图 片 的 处 理 运 用 ,本 章 将 进一步 学 习 对 图 形 、 动 画 、 音 频 和 视频 等 多 媒体 的 应 用 
开发 。 


8.1 2D.3D EE 
esl? 


Android 系统 的 图 形 处 理 能 力 非常 强大 , 它 自 定义 了 一 系列 2D 图 形 处 理 类 ,这 些 类 分 别 
位 于 android. graphics, android. graphics. drawable. Opshapes 和 android. view. animation 包 
中 。 对 于 3D 图 形 的 处 理 ,Android 集成 了 OpenGL ES 1. 0 提供 的 高 效 3D 图 形 处 理 技术 ,这 
些 类 分 别 位 于 javax. microedition. khronos. opengles 和 android. opengl 包 中 。 下 面 分 别 
介绍 。 


8.1.1 2D 图 形 相 关 类 


Android 在 其 android. graphics 包 中 提供 了 完整 的 本 机 的 2D 图 形 库 。 在 android. graphics 包 
中 常用 类 有 : Color 类 Paint 类 、Canvas 类 、Path 类 和 Drawable 类 。 


1. Color 类 


Android 中 的 颜色 用 4 个 数字 表示 ,它们 分 别 指 定 透明 度 、 红 色 、 绿 色 、 蓝 色 (Alpha、Red、 
Green、Blue,ARGB) 所 占 的 比重 ,每 个 数字 取 值 在 0 一 255 之 间 ( 如 果 使 用 二 进 制 数 制 表示 , 则 
占 8 位 )。 由 于 每 个 数字 占 8 位 ,因此 一 种 颜色 通常 需要 32 位 整数 来 表示 。 为 了 编程 方便 , 常 
常 使 用 十 六 进 制 的 数字 来 表示 颜色 。 

红 \ 绿 、 蓝 的 数字 大 小 代表 颜色 的 深浅 度 ,数字 越 小 颜色 越 深 ,数字 越 大 颜色 越 浅 。 但 是 透 
明度 则 不 然 ,透明 度 取 0 时 表示 完全 透明 , 取 255 时 表示 颜色 完全 不 透明 。 

在 开发 中 ,如 果 可 能 ,最 好 在 一 个 XML 资源 文件 中 定义 应 用 所 需 的 颜色 。 这 样 ,以 后 可 
以 在 一 个 地 方 轻松 地 更 改 这 些 颜 色 定义 ,就 可 以 使 得 运用 到 这 种 颜色 的 地 方 发生 改 变 而 不 需 
要 到 处 对 代码 进行 修改 了 。 在 前 面 的 章节 中 已 经 多 次 使 用 XML 资源 文件 定义 颜色 。 例 如 在 
XML 文件 中 定义 一 个 紫红 色 的 名 为 mycolor 的 颜色 ,代码 如 下 。 


<?xml version = "1.0" encoding = "utf 一 8"?> 
<resources> 
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< color name = "nycolor"» £ 7fff00ff </color > 
«/resources 


这 时 ,可 在 Java 代码 中 通过 名 称 来 引用 颜色 ,例如 代码 : 

Int color = getResources( ) . getColor(R.color.mycolor); 

代码 中 ,getResources() 方 法 返回 当前 Activity 的 ResourceManager 类 ,getColor() 方 法 
是 要 求 管理 器 根据 资源 ID 查找 指定 的 颜色 。 


如 果 没 有 在 XML 文件 中 定义 颜色 ,可 以 在 Java 代码 文件 中 使 用 十 进 制 数字 来 定义 颜色 ， 
或 使 用 系统 预定 义 的 标准 颜色 。 代 码 如 下 。 


color = Color.argb(127,255,0,255); // 使 用 十 进 制 数 表示 紫红 色 
color = Color. BLUE; // 使 用 系统 预定 的 蓝 色 颜色 值 
2. Paint 类 


Paint 类 是 Android 本 机 图 形 库 中 最 重要 的 类 之 一 。 它 包含 样式 .颜色 以 及 绘制 任何 图 形 
所 需 的 其 他 信息 。Paint 类 常用 方法 如 表 8-1 所 示 。 


表 8-1 Paint 类 常用 的 方法 及 说 明 


方 法 返回 值 描 x 

setARGB(int a, int r, int g, int b) void 设置 Paint 对 象 颜色 

setAlpha(int a) void 设置 alpha 不 透明 度 ,范围 为 0 一 255 

setColor(int color) void 设置 颜色 ,这 里 Android 内 部 定义 的 有 Color 类 ， 
包含 一 些 常 用 颜色 定义 

setTextAlign(Paint. Align align) void 设置 文本 对 齐 

setTextSize(float textSize) void 设置 字体 大 小 

setTypeface(Typeface typeface) Typeface 设置 字体 ,Typeface 包含 字体 的 类 型 .粗细 ,还 有 
倾斜 .颜色 等 


例如 在 Java 代码 中 设置 浅 灰 色 的 预定 义 颜色 ,可 使 用 setColor() 方 法 ,代码 如 下 。 


myPaint. setColor(Color.LTGRAY); 


3. Canvas 类 


Canvas 类 代表 可 以 在 其 上 绘图 的 画布 。 最 初 ,画布 启动 时 上 面 没有 任何 内 容 , 就 像 一 
张 白 纸 一 样 。 利 用 Canvas 类 中 的 各 种 方法 可 以 在 画布 上 绘制 线条 矩形、 圆 以 及 其 他 任意 
图 形 。 

Android 中 的 显示 屏幕 是 由 Activity 类 的 对 象 表 现 的 ,而 Activity 类 的 对 象 引 用 的 是 
View 类 的 对 象 ,而 View 类 的 对 象 又 是 引用 Canvas 类 的 对 象 。 这 一 系列 的 类 引用 ,通过 重 写 
View. onDraw() 方 法 ,可 以 在 指定 的 画布 上 绘图 。onDraw() 方 法 只 有 一 个 参数 , 它 用 于 指定 
所 在 的 画布 对 象 。Canvas 类 常用 的 方法 如 表 8-2 Bros 。 
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表 8-2 Canvas 类 常用 的 方法 及 说 明 


5 È 


LEE: 


drawText(String text, float x, float y, Paint 


paint) 


drawTextOnPath CString text, Path path. 
float x, float y, Pating paint) 
drawPoint(float x, float y, Pating paint) 


drawLine(float startX, float startY, float 


endX, float endY, Pating paint) 


drawCircle(float cx, float cy, float radius. 
Pating paint) 

drawOvalCRectF oval, Pating paint) 
drawRect(RectF oval, Pating paint) 
drawPath(Path path, Paint paint) 


4. Path 3€ 


在 屏幕 上 描绘 文字 ,参数 text 是 String 类 型 的 文本 ,参数 x 
为 水 平 轴 坐 标 , 参 数 y 为 垂直 轴 坐 标 ,参数 paint 为 画 刷 
对 象 

在 屏幕 上 沿 着 图 形 的 轨迹 描绘 文字 


画 点 ,参数 x 为 水 平 轴 坐 标 ,参数 y 为 垂直 轴 坐 标 ,参数 
paint 为 画 刷 对 象 

画 线 ,参数 startX 为 起 始点 的 x 坐标 ,参数 startY 为 起 始点 
的 y 坐 标 ,参数 endX 为 终点 的 x 坐标 ,参数 eyndY 为 终点 
的 y 坐标 ,参数 paint 为 画 刷 对 象 

画 圆 ,参数 cx 是 圆心 点 的 x 坐标 ,参数 cy 是 圆心 点 的 y 坐 
标 ,参数 radius 是 半径 ,参数 paint 为 画 刷 对 象 

ii f DR] ,参数 oval 为 一 个 区 域 

MEJE ,参数 oval 为 一 个 区 域 

画 一 个 路 径 ,参数 path 为 路 径 对 象 


Path 类 包含 一 组 矢量 绘图 命令 ,例如 画 线条 , 画 和 矩形 和 画 曲 线 等 。 例 如 画 一 个 圆 形 ,其 贺 
心 坐标 为 x=160,y=180; 半径 为 118 像素 ; 绘制 方向 为 顺 时 针 。 实 现 的 代码 如 下 。 


circle = new Path(); 


circle. addCircle(160, 180,118, Direction. CW); 


这 里 ,Direction. CW 为 顺 时 针 方 向 ,而 Direction. CCW it £F 77 [8] 


5. Drawable 类 


Android 中 的 Drawable 类 主要 针对 位 图 或 纯色 的 可 视 元 素 ,如 按钮 .视图 背景 等 。 


Drawable 类 支持 的 格式 如 表 8-3 所 示 。 


表 8-3 Drawable 类 支持 的 格式 及 描述 


格 式 描 述 
Bitmap( 位 图 ) PNG 或 JPEG 图 像 
NinePatch( 九 宫 格 ) 一 种 可 扩展 的 PNG 图 像 ,主要 用 作 大 小 可 调整 的 位 图 按钮 的 背景 
Shape( 形 状 ) 基于 Path 类 的 矢量 绘图 命令 
Layers( 图 层 ) 盛 放 子 绘图 区 的 容器 
States( 状 态 ) 一 个 容器 ,主要 用 于 选择 不 同 的 按钮 并 设置 按钮 的 焦点 状态 
Levels( 级 别 ) 一 个 容器 ,主要 用 于 电池 或 信号 强度 指示 器 
Scale( 缩 放 ) 包含 一 个 子 绘图 区 的 容器 ,能 根据 可 绘图 区 的 当前 级 别 调整 其 大 小 。 


用 于 可 缩放 的 图 片 查看 器 


可 绘图 区 一 般 都 在 XML 文件 中 定义 。 例 如 ,定义 一 个 颜色 从 浅 绿 到 果 绿 渐变 的 可 绘图 
区 , 且 渐 变 的 方向 是 从 上 向 下 的 , 则 在 XML 中 代码 如 下 。 
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<?xml version = "1.0" encoding = "utf - 8"?> 
< shape xmlns :android = "http: //schemas. android. com/apk/res/android"> 
« gradient 
android:startColor = " # ffe9f5db" 
android:endColor = " # ffabdb77" 
android:angle - "270"/» 
«/shape» 


这 里 ,标签 < gradient > 定义 渐变 色 , 属 性 startColor 为 开始 颜色 ,endColor 为 结束 颜色 ， 
angle 为 渐变 方向 ,其 值 所 代表 的 方向 如 表 8-4 所 示 。 
表 8-4 属性 angle 的 取 值 及 对 应 的 渐变 方向 
值 渐变 显示 方式 值 渐变 显示 方式 


0 开始 色 在 左 , 结 束 色 在 右 的 横向 渐变 90 开始 色 在 下 ,结束 色 在 上 的 纵向 渐变 
180 开始 色 在 右 , 结 束 色 在 左 的 横向 渐变 270 开始 色 在 上 ,结束 色 在 下 的 纵向 渐变 


使 用 这 个 可 绘图 区 的 方法 有 两 种 : 一 是 在 XML 中 以 android: background = Jib PEX RIJÉ- 
式 引用 它 ; 二 是 在 视图 的 onCreate() 方 法 中 调用 Canvas. setBackgroundResource() 方 法 。 


8.1.2 绘制 2D 图 形 案例 


【案例 8. 1】 在 渐变 的 背景 上 画 一 空心 圆 , 圆 内 以 环形 的 方式 显示 文字 串 。 

【说 明 】 定义 背景 色 的 XML 文件 是 存放 在 res/drawable 目录 下 的 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 2DGraphics 的 Android 项 目 。 其 应 用 程序 名 
为 GraphicsDemo, 包 名 为 cn. com. sgmsc. Graphics, Activity 组 件 名 为 GraphicsActivity。 

(2) 创建 颜色 资源 。 在 res/values 目录 下 创建 一 个 colors. xml 文件 ,用 于 定义 渐变 背景 
色 的 开始 和 结束 颜色 ,定义 文字 的 颜色 。 代 码 如 下 所 示 。 


1 <?xml version="1.0" encoding= "utf 一 8"?> 

2 «resources» 

3 < color name = "startcl"># ffe9f5db «/color» 
4 <color name = "endcl"»£ ffabdb77 </color > 

5 < color name = "nycolor"»£ 7fff00ff </color > 
6 «/resources» 


(3) 创建 背景 资源 。 在 图 片 资源 目录 res/drawable-mdpi 下 创建 一 个 background. xml X 
件 , 用 于 定义 屏幕 的 背景 色 。 代 码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf 一 8"?> 

2 «shape xmlns:android = "http://schemas.android. com/apk/res/android"> 

3 < gradient 

4 android:startColor = "(Qcolor/startcl" 

5 android:endColor = "(Z.color/endcl" 

6 android:angle - "270" /» 

7 «/shape» 

(4) 设计 布局 。res/layout 目录 下 的 main. xml 文件 很 简单 ,因为 背景 色 和 绘图 、 写 文字 
都 在 其 他 的 文件 中 设置 ,所 以 在 这 个 布局 文件 中 只 需要 定义 一 个 线性 布局 层 就 可 以 了 。 代 码 
如 下 所 示 。 
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1 <?xml version = "1.0" encoding = "utf - 8"?» 
2 < LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 


3 android:orientation = "vertical" 
4 android:layout width- "fill parent" 
5 android:layout height- "fill parent"> 


6 «/LinearLayout > 


(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Graphics 包 下 的 GraphicsActivity. java X 
件 , 并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. Graphics; 


2 

2 

3 import android. app. Activity; 

4 import android. content. Context; 
5 import android. graphics. Canvas; 
6 import android. graphics. Color; 
7 import android. graphics. Paint; 
8 import android. graphics. Path; 

9 import android. graphics. Path. Direction; 
10 import android. os. Bundle; 

11 import android. view. View; 


13 public class GraphicsActivity extends Activity { 
14 @Override 
15 public void onCreate(Bundle savedInstanceState) ( 


16 super. onCreate(savedInstanceState); 

17 setContentView(new GraphicsView(this)); 

18 H 

19 

20 static public class GraphicsView extends View { 

21 private static final String CIRCLETXT = "Android 应 用 开发 教程 ”- 第 一 版 .2012.12"; 
22 private final Path circle; 

23 private final Paint cir Paint; 

24 private final Paint txt Paint; 

25 

26 public GraphicsView(Context context) { 

27 super(context); 

28 circle = new Path(); 

29 circle.addCircle(160, 180, 118, Direction.CW); 

30 // 定 义 画 圆 的 相关 属性 : 消 饥 齿 .空心 圆 . 颜 色 、 线 粗细 

31 cir Paint = new Paint(Paint.ANTI ALIAS FLAG); 

32 cir Paint. setStyle(Paint. Style. STROKE) ; 

33 cir Paint.setColor(Color.argb(255, 202, 232, 170)); 

34 cir Paint. setStrokeWidth(6); 

35 // 定 义 圆 内 环形 文本 的 相关 属性 : 消 锅 齿 、 实 心 字 、 颜 色 、 字 号 
36 txt Paint = new Paint(Paint.ANTI ALIAS FLAG); 

37 txt Paint.setStyle(Paint.Style.FILL AND STROKE); 

38 txt Paint. setColor(Color. GRAY); 

39 txt Paint. setTextSize(20f); 

40 setBackgroundResource(R. drawable. background) ;// 定 义 渐变 背景 色 
41 } 

42 @Override 

43 protected void onDraw( Canvas canvas) { 

44 canvas.drawPath(circle, cir Paint); 


45 canvas. drawTextOnPath(CIRCLETXT, circle, 0, 26, txt Paint); 
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(D 第 20 一 47 行 定义 一 个 静态 的 内 部 类 GraphicsView, 它 继承 自 View 类 。 这 个 类 包含 
一 个 Canvas。 在 这 个 类 中 定义 了 两 个 方法 : GraphicsView CO) 和 onDraw (),onDraw () 在 
GraphicsView() 初 始 化 完成 之 后 开始 调用 。 

四 第 26—41 行 定 义 的 是 GraphicsView() 方 法 。 其 中 ,第 28、29 行 创 建 一 个 矢量 图 形 对 
象 circle, 这 个 circle 是 一 个 圆 形 对 象 , 其 圆心 坐标 为 x=160, 
y=180; 半径 为 118 像素 ; 绘制 方向 为 顺 时 针 。 第 31 一 34 行 有 EEC 
设置 图 形 对 象 cir_Paint 的 若干 属性 值 : 消 锯齿 、 空 心 圆 、 颜 
E RHM. F 36 一 39 行 设置 图 形 对 象 txt_Paint 的 若干 属 
性 值 : 消 锯齿 .实心 字 ,颜色 .字号 。 第 40 行 设置 画面 绘图 区 
的 背景 色 。 

@ 第 43 一 46 行 定义 了 onDraw() 方 法 。 第 44 行 按照 cir_ 
Paint 指定 的 属性 画 出 circle 来 ; 第 45 行 沿 着 circle 的 轨迹 描 
绘 文字 ,文字 内 容 取 自 CIRCLETXT 常量 , 且 文 本 的 属性 由 
txt_Paint 指定 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 2DGraphics 项 目 , 显 示 效 果 如 图 8-1 所 示 。 


8.1.3 3D 图 形 编程 Eel RAIAR 


本 节 将 对 Android 平台 下 的 3D 编程 进行 简单 介绍 ,并 通过 一 些 案例 来 说 明 如 何 使 用 
GLSurfaceView 及 OpenGL ES 标准 来 开发 3D 应 用 程序 。 由 于 3D 编程 涉及 的 知识 非常 多 ， 
这 里 无 法 一 一 涵盖 ,所 以 只 是 对 其 原理 和 开发 流程 作 简单 的 介绍 。 


1. OpenGL ES 简介 


Android 通过 OpenGL ES API, 可 以 支持 高 性 能 的 3D 图 形 ,而 OpenGL ES 是 OpenGL 
的 子 集 。 

OpenGL 是 个 专业 的 3D 图 形 软 件 接口 标准 ,是 由 SGT 公司 开发 的 一 套 功 能 强大 、 调 用 方 
便 的 底层 3D 图 形 库 。OpenGL ESCH OpenGL for Embedded System 的 缩写 ) 是 为 适用 于 内 
入 式 设备 ,根据 OpenGL 规范 进行 裁剪 后 ,形成 的 一 套 精简 标准 。 其 官方 网 址 为 http:// 
www. khronos. org。 它 适用 于 手机 、PDA 或 其 他 移动 终端 的 3D 显示 应 用 。 

OpenGL ES 1.0 和 1.1 API 规范 从 Android 1.0 就 开始 支持 了 。 自 Android 2. 2(API 
Level 8) 以 后 ,框架 支持 OpenGL ES 2. 0 API 规范 ,OpenGL ES 2. 0 被 大 多 数 Android 设备 
所 支持 并 被 推荐 在 新 的 基于 OpenGL 的 应 用 中 使 用 。Android 2. 0 版 本 之 后 图 形 系统 的 底 
层 泻 染 均 由 OpenGL 负责 ,OpenGL 除了 负责 处 理 3D API 调用 ,还 需 负责 管理 显示 内 存 及 
处 理 Android SurfaceFlinger 或 上 层 应 用 对 其 发 出 的 2D API 调用 请 求 。 注 意 ,OpenGL 2. 0 
向 下 兼容 到 OpenGL 1. 5 ,而 OpenGL ES 2. 0 和 OpenGL ES 1. x 不 兼容 ,是 两 种 完全 不 同 的 
实现 。 

Android 提供 基于 OpenGL ES 标准 的 三 维 图 形 库 , 其 3D 图 形 系 统 分 为 Java 框架 和 本 地 
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代码 两 部 分 。 本 地 代码 主要 实现 OpenGL 接口 的 库 , 在 Java 框架 层 ,其 标准 的 OpenGL 包 是 
javax. microedition. khronos. opengles ,而 android. opengl 包 则 提供 OpenGL. 系统 和 Android 
GUI 系统 之 间 的 联系 。Android 支持 OpenGL 列表 有 GL,GL 10,GL 10 EXT,GL 11 等 ,这 
X6 GL 都 是 公共 接口 , 它 包含 Java 程序 语言 为 OpenGL 绑 定 的 核心 功能 。 本 书 将 使 用 GL10 
这 个 类 来 接触 OpenGL ,探索 3D 领域 。 


2. 3D 开发 基本 


1) 3D 图 形 的 构成 

构成 3D 图 形 的 最 基本 的 单位 是 顶点 (Vertex), 它 代表 空间 中 的 一 个 点 。 通 过 若干 个 点 
可 以 构成 多 边 形 , 通 过 多 边 形 又 可 以 构成 更 复杂 的 空间 物体 。OpenGL 可 以 支持 多 种 多 边 形 ， 
而 OpenGL ES 所 支持 的 基本 图 形 只 有 点 (Point) 、 线 (Line) 和 三 角形 (Triangle) ,任何 其 他 的 
3D 图 形 都 是 通过 这 几 种 基本 几何 图 形 组 合 而 成 。 

在 OpenGL ES 中 ,表示 顶点 由 三 个 数值 确定 ,分 别 表 示 x、y、z 三 个 坐标 值 。 直 线 由 两 个 
顶点 索引 值 表示 。 三 角形 由 三 个 顶点 索引 值 表示 。 表 示 一 个 点 的 颜色 时 ,由 4 个 数值 确定 ,分 
别 表示 色彩 值 R.G、B、A 的 值 。 

一 般 将 构成 空间 物体 的 项 点 的 坐标 值 以 顶点 数组 的 形式 给 出 。 顶 点 数组 包括 3D 场景 中 
部 分 或 全 部 的 顶点 坐标 数据 ,其 中 每 三 个 数组 元 素 表示 一 个 顶点 的 坐标 。 例 如 ,场景 中 有 三 个 
顶点 A(1,2,3)、B(4,5,6)、C(7,8,9), 则 其 顶点 数组 为 {1,2,3,4,5,6,7,8,9)。 类 似 地 ,三 角 
形 、 顶 点 颜色 也 是 由 数组 来 描述 的 。 

2) 绘制 3D 图 形 的 方法 

OpenGL ES 提供 了 两 类 方法 来 绘制 一 个 空间 几何 图 形 。 一 个 是 glDrawArraysO , 5 — 
个 是 glDrawElementsO 。 

public abstract void glDrawArrays(int mode. int first, int count) 使 用 VetexBuffer 来 绘 
制 , 顶 点 的 顺序 由 vertexBuffer 中 的 顺序 指定 。 

public abstract void glDrawElements(int mode, int count, int type, Buffer indices) 可 以 
重新 定义 顶点 的 顺序 ,顶点 的 顺序 由 indices 指定 。 这 里 , mode 值 可 取 如 下 常量 : GLL 
POINTS( 绘 制 独立 的 点 )GL_LINE_STRIP( 绘 制 一 条 线段 )\GL_LINE_LOOP( 绘 制 一 条 封 
闭 线 段 , 即 首尾 相连 ) .GL_LINES( 绘 制 多 条 线段 )、.GL_TRIANGLES( 绘 制 多 个 三 角形 , 且 两 
两 不 相 邻 )、GL_TRIANGLE_STRIP( 绘 制 多 个 三 角形 , 且 两 两 相 邻 )、GL_TRIANGLE_FAN 
(以 一 个 点 为 顶点 绘制 多 个 相 邻 的 三 角形 ) 等 。 

对 应 顶点 ,除了 可 以 为 其 定义 坐标 外 ,还 可 以 指定 颜色 .材质 法 线 ( 用 于 光照 处 理 ) 等 。 
glEnableClientState 和 glDisableClientState 可 以 控制 的 管道 (Pipeline) 开 关 有 : GL_COLOR_ 
ARRAY (颜色 )\GL_NORMAL_ARRAY (法 线 )\GL_TEXTURE_COORD_ARRAY( 材 
质 )、.GL_VERTEX_ARRAY( 顶 点 ) 等 。 相 关 的 方法 如 下 。 

(D glColorPointer(int size,int type,int stride. Buffer pointer) ,传人 颜色 。 

(2) glVertexPointer(int size, int type, int stride, Buffer pointer) ,传人 顶点 。 

(3) glTexCoordPointer(int size. int type. int stride. Buffer pointer) ,传人 材质 。 

(4) glNormalPointer(int type. int stride, Buffer pointer) ,传人 法 线 。 

OpenGL ES 内 部 存放 图 形 数据 的 Buffer fi COLOR,DEPTH (深度 信息 ) 等 ,在 绘制 图 形 
之 前 一 般 需要 清空 COLOR 和 DEPTH 的 Buffer。 
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3) 3D 开发 的 关键 步骤 
接 下 来 简单 介绍 一 下 开发 OpenGL 程序 的 几 个 关键 步骤 。 
COD 首先 在 当前 Activity 的 onCreate() 方 法 中 实例 化 GLSurfaceView., 


GLSurfaceView gl = new GLSurfaceView(this); 


GLSurfaceView 是 一 个 视图 ,继承 至 SurfaceView. © P3 fJ. surface 专门 负责 OpenGL 
泻 染 ,用 于 构建 一 个 使 用 OpenGL ES 进行 部 分 或 全 部 谊 染 的 应 用 程序 。 

(2) 自 定义 MyRenderer 实现 android. opengl. GLSurfaceView. Renderer 接口 ,并 重 写 三 
个 抽象 方法 。 

public abstract void onSurfaceCreated(GL10 gl, EGLConfig config) 

public abstract void onSurfaceChanged(GL10 gl, int width, int height) 

public abstract void onDrawFrame(GL10 gl) 

这 些 方法 很 容易 理解 ,onSurfaceCreated() 方 法 在 surface 创建 以 后 调用 ,onSurfaceChanged() 
方法 是 在 surface 发 生 改变 以 后 调用 ,例如 从 竖 屏 切换 到 横 屏 的 时 候 ,onDrawFrame() 方 法 是 
当 任 何 时 候 调用 一 个 画图 方法 的 时 候 调用 。 

(3) 给 GLSurfaceView 对 象 注册 一 个 Renderer。 


gl.setRenderer(new MyRenderer()) ; 
(4) 设置 当前 上 下 文 内 容 视图 。 
this. setContentView(gl); 


在 3D 图 形 编程 中 ,需要 注意 以 下 两 方面 。 

一 是 生命 周期 (Activity Lifecycle). ?4 Activity 暂停 和 恢复 时 , 必须 通知 
GLSurfaceView。 当 Activity 暂停 时 需要 通知 GLSurfaceView 调用 onPauseO , 当 Activity W 
复 时 需要 通知 GLSurfaceView 调用 onResume()。 这 些 调用 人 允许 GLSurfaceView 暂停 和 恢 
复 泻 染 的 线程 ,同时 允许 GLSurfaceView 释放 和 重 构 OpenGL 显示 。 

二 是 演 染 模式 (Rendering Mode) 。 在 设置 Renderer 后 ,可 以 通过 调用 setRenderMode(int) 来 
控制 是 否 持续 呈现 或 者 点 播 。 默 认 情况 下 持续 呈现 。 


3. 3D 编程 案例 


下 面 通过 三 个 3D 应 用 案例 ,帮助 读者 初步 了 解 3D 编程 的 方法 ,体会 一 下 3D 应 用 的 
效果 。 

【案例 8.2】 设计 一 个 自动 旋转 的 非 透 明 彩色 立方 体 ,立方 体 的 各 顶点 颜色 不 同 。 

【说 明 】 本 例 需 要 至 少 设计 两 个 类 ,一 个 是 Activity 类 ,在 其 中 的 onCreate() 方 法 内 , 需 
要 创建 一 个 GLSurfaceView 对 象 , 设 置 绘制 模式 。 另 一 个 是 继承 Renderer 的 子 类 ,用 于 定义 
3D 图 形 的 绘制 . 泻 染 及 其 交互 动作 等 。 本 例 的 开发 重点 是 在 逻辑 代码 上 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 3DCube_1 的 Android 项 目 。 其 应 用 程序 名 
为 Cube_1, 包 名 为 cn. com. sgmsc. Cube 1.Activity 组 件 名 为 CubelActivity。 

(2) 设计 布局 。 本 例 是 设计 一 个 自动 旋转 的 立方 体 ,屏幕 上 不 需要 其 他 的 控件 ,所 以 在 
res/layout 目录 中 的 布局 文件 main. xml 很 简单 ,只 需要 定义 一 个 线性 布局 即 可 。 
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(3) 开发 启动 Activity 代码 。 打 开 src/cn. com. sgmsc. Cube 1 包 下 的 CubelActivity. 


java 文件 . H 


编辑 之 。 代 码 如 下 所 示 。 


package cn. con. sgnsc. Cubel ; 


import android. app. Activity; 
import android. opengl. GLSurfaceView; 


import android. view. WindowManager; 
import android. view. Window; 


X 
2 
3 
4 
5 import android. os. Bundle; 
6 
1 
8 
9 


public class CubelActivity extends Activity ( 


11 GLSurfaceView GLview; 


13 /** 当 这 个 activity 首次 创建 时 调用 */ 
14 @Override 
15 public void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 


/* 设置 窗 体 为 全 屏 模式 ,无 标题 * / 
getWindow().addFlags(WindowManager.LayoutParams.FLAG FULLSCREEN); 
getWindow().requestFeature(Window.FEATURE NO TITLE); 


/* 创建 一 个 GLSurfaceView 用 于 绘制 表面 / 


GLSurfaceView GLview = new GLSurfaceView(this); 


/* 设置 Renderer 用 于 执行 实际 的 绘制 工作 * / 
GLview. setRenderer(new MyGLRenderer(this)); 


/* 设置 绘制 模式 为 持续 绘制 * / 
GLview. setRenderMode(GLSurfaceView.RENDERMODE CONTINUOUSLY); 


/* 将 创建 好 的 GLSurfaceView 设置 为 当前 Activity 的 内 容 视图  / 
setContentView(GLview); 


第 23,26,32 行 是 3D 开发 不 可 缺少 的 步骤 。 其 中 ,GLSurfaceView 对 象 GLview 调用 方 
法 setRenderer(new MyGLRenderer(this)) 对 自动 旋转 的 3D 立方 体 进行 绘制 ,定义 绘制 并 自 
动 旋转 的 代码 将 在 自 定义 的 MyGLRenderer 类 中 实现 。 

(4) 开发 3D 效果 泻 染 器 代码 。 在 src/cn. com. sgmsc. Cube_1 包 下 创建 一 个 代码 文件 
MyGLRenderer. java, 该 文件 是 定义 一 个 Renderer 子 类 ,并 重 写 其 中 的 抽象 方法 onDrawFrame()、 
onSurfaceChanged() 和 onSurfaceCreated()。 其 代码 如 下 所 示 。 


ounou wne 


package cn. com. sgnsc. Cubel ; 


import java. nio. ByteBuffer; 

import java. nio. ByteOrder; 

import javax. microedition. khronos. egl. EGLConfig; 
import javax. microedition. khronos. opengles. GL10; 
import android. opengl. GLSurfaceView. Renderer; 
import android. opengl. GLU; 
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public class MyGLRenderer implements Renderer { 
public MyGLRenderer(CubelActivity main) { 
createBuffers(); 
} 


public void onSurfaceCreated(GL10 gl, EGLConfig config) { 
gl.glDisable(GL10.GL DITHER); // 颜 色 抖动 据说 可 能 严重 影响 性 能 ,禁用 
gl.glClearColor(0.0f, 0.0f, 0.0f, 1.0f); // 设 置 清除 颜色 缓冲 区 时 用 的 RGBA 颜色 值 


gl.glEnable(GL10.GL DEPTH TEST); 
gl.glDepthFunc(GL10.GL  LEQUAL); 
gl.glClearDepthf(1f); 

} 


public void onSurfaceChanged(GL10 gl, int width, int height) { 
// 宽 高 比 
float aspect = (float) width / (float) (height == 0? 1 : height); 


// 设 置 视 口 
gl.glViewport(0, 0, width, height); 


/ [PACA TL EXE LOS BERE AE I, TEES Pe CE D FA E 
gl.glMatrixMode(GL10.GL PROJECTION); 
gl. glLoadIdentity(); 


GLU. gluPerspective(gl, 45.0f, aspect, 0.1f, 200.0f); 
GLU.gluLookAt(gl, 5f, 5f, 5f, Of, Of, Of, 0, 1, 0); 

) 

public void onDrawFrame(GL10 gl) ( 
//…… 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 


private void createBuffers() { 
// 创 建 顶点 缓冲 ,顶点 数组 使 用 float 类 型 ,每 个 float 长 4 个 字 节 
vertices = ByteBuffer.allocateDirect(data vertices. length * 4); 
// 设 置 字 节 顺序 为 本 机 顺序 
vertices. order(ByteOrder. nativeOrder()); 
// 通 过 一 个 FloatBuffer 适配器 ,将 float 数组 写 人 ByteBuffer 中 
vertices.asFloatBuffer().put(data vertices); 
// 重 置 Buffer 的 当前 位 置 


vertices. position(0); 


// 创 建 三 角形 顶点 索引 缓冲 ,索引 使 用 byte 类 型 ,所 以 无 须 设置 字 节 顺序 ,也 无 须 写 人 适 配 
triangles = ByteBuffer.allocateDirect(data triangles.length * 2); 
triangles.put(data triangles); 

triangles. position(0); 


colors - ByteBuffer.allocateDirect(data colors.length * 4); 
colors. order(ByteOrder. nativeOrder()); 
colors.asFloatBuffer().put(data colors); 

colors. position(0); 


f 


private ByteBuffer vertices; 
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64 private ByteBuffer triangles; 
65 private ByteBuffer colors; 
66 


67 private float anglex = 0f; 

68 private float angley = 0f; 

69 private float anglez - 0f; 

70 

71 private float[] data vertices = ( 

72 LLI 1; 1,43, -p-k 11,1, 

73 Liri dao 1, 51,2 clL91,291, 131-1, 
74 h 

75 

76 private float[] data colors = ( 

TI 1,1,0,1, 1,0,1,1, 0,1,1,1, 1,0,0,1, 

78 titi 0,0, 3, 1, 0; 1,0,3, 1,1,.1,1, 

79 }; 

80 

81 private byte[] data triangles = { 

82 0,1,2, 0,2,3, 0,3,7, 0,7,4, 0,4,5, 0,5,1, 
83 6,5,4, 6,4,7, 6,7,3, 6,3,2, 6,2,1, 6,1,5 
84 H 

85 ) 


加 第 11 一 13 行 ,定义 构造 方法 ,在 其 中 调用 创建 缓冲 的 方法 createBuffers ( )。 
createBuffers() 方 法 在 第 26 一 45 行 中 定义 ,在 其 中 定义 了 顶点 、 三 角形 顶点 索引 和 色彩 三 个 
缓冲 区 。 

© 58 15—22 行 是 重 写 抽象 方法 onSurfaceCreatedO 。 

© 第 24 一 37 行 是 重 写 抽象 方法 onSurfaceChanged() 。 

(D 58 63—84 行 声 明和 定义 本 类 中 使 用 的 变量 和 数组 ,并 赋 初 值 。 

接 下 来 对 省 略 的 部 分 代码 作 解 析 。 这 部 分 省 略 的 代码 是 重 写 抽象 方法 onDrawFrame() 。 
具体 代码 如 下 。 

public void onDrawFrame(GL10 gl) ( 


// 清 除 颜色 缓冲 
gl.glClear(GL10.GL COLOR BUFFER BIT | GL10.GL DEPTH BUFFER BIT); 


// 即 随后 的 矩阵 操作 将 应 用 到 要 绘制 的 模型 上 
gl. glMatrixMode(GL10.GL MODELVIEN); 


1 
2 
3 
4 
5 // 设 置 当前 矩阵 堆栈 为 模型 堆栈 ,并 重 置 堆栈 
6 
7 
8 gl.glLoadIdentity(); 


9 

10 gl.glLightfv(GL10.GL LIGHTO, GL10.GL POSITION, new float[](5, 5, 5, 1), 0); 
11 

12 // 将 旋转 矩阵 应 用 到 当前 矩阵 堆栈 上 , 即 旋转 模型 

13 gl.glRotatef(anglez, 0, 0, 1); 

14 gl.glRotatef(angley, 0, 1, 0); 

15 gl.glRotatef(anglex, 1, 0, 0); 

16 anglex *- 0.1; // 递 增 角度 值 以 便 每 次 以 不 同 角度 绘制 
17 angley += 0.2; 

18 anglez += 0.3; 

19 


20 // 启 用 顶点 数组 ,法 向 量 .颜色 数组 
21 gl.glEnableClientState(GL10.GL VERTEX ARRAY); 
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35,36 行 禁用 相关 数组 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 , 然 
后 运行 3DCube_1 项 目 , 便 可 在 屏幕 上 看 到 一 个 八 色 渐变 
的 彩色 旋转 正方 体 ,如 图 8-2 所 示 。 

【案例 8.3】 设计 一 个 自动 旋转 的 半 透 明 的 贴图 立 
方 体 ,立方体 的 每 一 面 都 贴 着 相同 的 图 片 ,但 各 面 的 用 光 
和 前 背景 的 色彩 不 一 样 

【说 明 】 本 例 与 例 8. 2 的 设计 思想 一 样 ,不 同 之 处 
在 于 定义 Renderer 子 类 时 ,增加 了 绘图 纹理 的 处 理 和 浓 
染 , 少 了 对 顶点 的 颜色 设置 部 分 。 本 例 的 开发 重点 是 在 


gl.glEnableClientState(GL10.GL NORMAL ARRAY); 
gl.glEnableClientState(GL10.GL COLOR ARRAY); 


// 设 置顶 点 数组 指针 为 ByteBuffer 对 象 vertices 
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// 第 一 个 参数 为 每 个 顶点 包含 的 数据 长 度 (以 第 二 个 参数 表示 的 数据 类 型 为 单位 ) 


gl.glVertexPointer(3, GL10.GL FLOAT, 0, vertices); 
gl.glColorPointer(4, GL10.GL FLOAT, 0, colors); 


// 绘 制 triangles 表示 的 三 角形 
gl.glDrawElements(GL10.GL TRIANGLES, triangles. remaining(), 
GL10.GL UNSIGNED BYTE, triangles); 


// 禁 用 顶点 ,法 向 量 ,颜色 数组 
gl.glDisableClientState(GL10.GL VERTEX ARRAY); 
gl.glDisableClientState(GL10.GL COLOR ARRAY); 


一 10 行 是 重 置 缓冲 .堆栈 和 光源 ,为 随后 的 绘制 3D 图 形 做 准备 。 
© 第 12 一 18 行 设置 旋转 模型 。 
© 第 21 一 23 行 启用 相关 数组 ,为 3D 图 形 提 供 数 据 。 


行 绘制 图 形 和 着 色 。 


逻辑 代码 上 。 下 面 只 对 自 定义 的 Renderer 子 类 部 分 作 较 
详细 的 解析 。 "T 
【开发 步骤 及 解析 】 


CD 创建 项 目 。 在 Eclipse 中 创建 


为 Cube_2 


(TEARI, 准备 一 张 方形 图 片 作 为 纹理 贴图 ,将 其 复制 在 


一 个 自动 旋转 的 彩色 立方 体 


-个 名 为 3DCube_2 的 Android 项 目 。 其 应 用 程序 名 
, 包 名 为 cn. com. sgmsc. Cube 2.Activity 组 件 名 为 Cube2Activity。 


res/drawable-mdpi 目录 


中 。 注 意 : 有 些 设备 对 图 片 的 尺寸 有 要 求 ,其 长 宽 必须 是 2", 最 大 尺寸 不 能 超过 256 或 
102 T 

(3) 设计 布局 。 同 样 ,res/layout 目录 中 的 布局 文件 main. xml 中 也 是 只 有 简单 的 一 个 线 
性 布局 。 

OD 开发 启动 Activity 代码 。 编 辑 src/cn. com. sgmsc. Cube 2 包 下 的 Cube2Activity. 
java 文件 ,其 代码 与 案例 8. 2 中 CubelActivity. java 的 相同 ,在 此 不 作 歼 述 。 

(5) 开发 3D 效果 泻 染 器 代码 。 在 src/cn. com. sgmsc. Cube_2 包 下 创建 一 个 代码 文件 


MyGLRenderer. java, 该 文件 是 定义 一 个 Renderer 子 类 ,并 重 写 其 中 的 onDrawFrame() 方 法 、 


a Android 应 用 开发 教程 


onSurfaceChanged() 方 法 和 onSurfaceCreated() 方 法 ,3D 贴图 立方 体 及 动画 效果 在 该 子 类 中 
定义 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. Cube2; 


* 

2 

3 import java. io. InputStream; 

4 import java. io. IOException; 

5 import java. nio. ByteBuffer; 

6 import java. nio. ByteOrder; 

7 import javax. microedition. khronos. egl. EGLConf ig; 
8 import javax. microedition. khronos. opengles. GL10; 
9 import android. opengl.GLSurfaceView. Renderer; 

10 import android. opengl.GLUtils; 

11 import android. opengl.GLU; 

12 import android. content. Context; 

13 import android. graphics. Bitmap; 

14 import android. graphics. BitmapFactory; 


15 

16 public class MyGLRenderer implements Renderer { 
313 

18 public MyGLRenderer(Context context) { 

19 this.context - context; 

20 createBuffers(); 

21] 

22 


23 public void onSurfaceCreated(GL10 gl, EGLConfig config) ( 


24 //…… 省 略 一 : 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
25 } 


27 public void onSurfaceChanged(GL10 gl, int width, int height) { 
28 //.…… 省 略 二 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
29 } 


31 public void onDrawFrame(GL10 gl) ( 
32 //.…… 省 略 三 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 


33 T 

34 

35 private void createBuffers() { 

36 // 创 建 顶点 缓冲 , 顶点 数组 使 用 float 类 型 ,每 个 float 长 4 个 字 节 

37 vertices - ByteBuffer.allocateDirect(data vertices.length * 4); 
38 // 设 置 字 节 顺序 为 本 机 顺序 

39 vertices. order(ByteOrder. nativeOrder()); 

40 // 通 过 一 个 FloatBuffer 适配器 ,将 float 数组 写 人 ByteBuffer 中 

41 vertices.asFloatBuffer().put(data vertices); 

42 // 重 置 Buffer 的 当前 位 置 

43 vertices. position(0); 

44 

45 // 创 建 索引 缓冲 ,索引 使 用 byte 类 型 ,所 以 无 须 设置 字 节 顺序 ,也 无 须 写 入 适 配 
46 triangles = ByteBuffer.allocateDirect(data triangles.length * 2); 
47 triangles.put(data triangles); 

48 triangles. position(0); 

49 

50 tvertices - ByteBuffer.allocateDirect(data tvertices.length * 4); 
51 tvertices. order(ByteOrder. nativeOrder()); 


52 tvertices.asFloatBuffer().put(data tvertices); 
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53 tvertices. position(0); 


56 private void loadTexture(GL10 gl) { 
57 //.…… 省 略 四 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 


60 private Context context; 

61 private ByteBuffer vertices; 
62 private ByteBuffer triangles; 
63 private ByteBuffer tvertices; 
64 private int texture; 


66 rivate float anglex = 0f; 
67 private float angley = Of; 
68 private float anglez = Of; 


70 private float[] data vertices = ( 


71 -5.0f, -5.0f, -5.0f, -5.0f, 5.0f, -5.0f, 5.0f, 5.0f, -5.0f, 5.0f, 5.0f, -5.0f, 
5.0f, -5.0f, -5.0f, -5.0f, -5.0f, -5.0f, 

72 =5.0£,. —5.0£f, 5.0£, 5.0£, —5.0£, 5.0£, 5.0£, 5.0£, 5.0£, 5.0£, 5.0£, 5.0£, —5.0£, 
5,0£,.5.0£, —5.0£, —5.0£, 5.0£, 

"73 —-5.0£f, —5.0£, —5.0£, 5.0£, —-5.0£, —5.0£, 5.0£, —5.0£, 5.0£, 5.0£, —5.0£, 5.0£, 
-5.0£, —5.0£,:5.0£, —5.0£f, —5.0£, —5.0F, 

74 5.0£, —5.0£, —5.0£, 5.0£, 5.0£, —5.0£, 5. 0£, 5.0£, 5.0£, 5. 0£, 5. 0£, 5. 0£, 5. 0f; 
=5.0£, 5.0£, 5.0£, —5.0£, -5.0f, 

75 5.0£, 5. 0£, —5.0£, —5.0£, 5.0£, — 5. 0£, — 5.0£, 5.0£, 5.0£, —5.0£, 5.0£, 5. 0£, 
5.0£, 5.0£, 5.0£, 5.0£, 5.0£, —5.0£, 

76 —5.0£, 5.0£, —5.0£, —5.0£, —5.0£, —5.0£, —5.0£, —5.0£, 5.0£, —5.0£, —5.0£, 
5.0£, —5.0£, 5.0£, 5.0£, —5.0£, 5.0£, —5.0£, 

" t 

78 

79 private byte[ ] data_triangles = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 

80 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, }; 

81 


82 // 设 置 纹理 坐标 


83 private float[] data tvertices = ( 


84 1.0000f, 1.0000f, 1.0000f, 0.0000£, 0.0000£, 0.0000£, 0.0000£, 0.0000£, 
1.0000£, 1.0000£, 1.0000£, 

85 0.0000£, 1.0000£, 1.0000£, 1.0000£, 1.0000£, 0.0000£, 1.0000£, 0.0000£, 
0.0000£, 0.0000£, 1.0000£, 

86 0.0000£, 1.0000£, 1.0000£, 1.0000£, 1.0000£, 0.0000£, 1.0000£, 0.0000£, 
0.0000£, 0.0000£, 1.0000£, 

87 0.0000£, 1.0000£, 1.0000£, 1.0000£, 1.0000£, 0.0000£, 1.0000£, 0.0000£, 
0.0000£, 0.0000£, 1.0000£, 

88 0.0000£, 1.0000£, 1.0000£, 1.0000£, 1.0000£, 0.0000£, 1.0000£, 0.0000£, 
0.0000£, 0.0000£, 1.0000£, 

89 0.0000£, 1.0000£, 1.0000£, 1.0000£, 1.0000£, 0.0000£, 1.0000£, 0.0000£, 
0.0000£, 0.0000£, 1.0000£, 

90 ) 

91] 


本 例 是 设计 一 个 3D 贴图 立方 体 , 所 以 与 案例 8. 2 中 的 MyGLRenderer 子 类 定义 相 比 ,这 
里 多 了 加 载 贴图 纹理 的 方法 loadTextureO 。 


接 下 来 对 省 略 的 部 分 代码 作 解析 。 


0.0000f, 


0.0000f, 


0.0000f, 


0.0000f, 


0.0000f, 


0.0000f, 
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省 略 一 : 这 部 分 省 略 的 代码 是 重 写 抽象 方法 onSurfaceCreatedO 。 具 体 代 码 如 下 。 


1 public void onSurfaceCreated(GL10 gl, EGLConfig config) { 

2 

3 boolean SEE THRU - true; // 为 设置 透明 效果 的 判断 值 

4 gl. glDisable(GL10. GL_DITHER) ; // 禁 用 颜色 抖动 , 因为 可 能 严重 影响 性 能 
5 gl.glClearColor(0.0f, 0.0£, 0.0£, 1.0£); // 设 置 清除 颜色 缓冲 区 时 用 的 RGBA 颜色 值 
6 

7 

8 // 在 位 置 (1,1,1) 处 定义 光源 

9 float lightAmbient[] = new float[] { 0.3£, 0.3f, 0.3£, 1]; 

10 float lightDiffuse[] = newfloat[] (1, 1, 1, 1]; 

11 float[] lightPos = newfloat[] { 1, 1, 1, 1 }; 


12 gl.glEnable(GL10.GL LIGHTING); 

13 gl.glEnable(GL10.GL LIGHTO); 

14 // 设 置 环境 光 

15 gl.glLightfv(GL10.GL LIGHTO, GL10.GL AMBIENT, lightAmbient, 0); 
16 // 设 置 漫 射 光 

17 gl.glLightfv(GL10.GL LIGHTO, GL10.GL DIFFUSE, lightDiffuse, 0); 
18 // 设 置 光源 位 置 

19 gl.glLightfv(GL10.GL LIGHTO, GL10.GL POSITION, lightPos, 0); 


20 

21 // 定 义 立方 体 材质 

22 float matAmbient[] = new float[] (1, 1, 1, 1 }; 
23 float matDiffuse[] = newfloat[] (1, 1, 1, 1 ); 


24 gl.glMaterialfv(GL10.GL FRONT AND BACK, GL10.GL AMBIENT, matAmbient, 0); 
25 gl.glMaterialfv(GL10.GL FRONT AND BACK, GL10.GL DIFFUSE, matDiffuse, 0); 
26 

27 // 设 置 需要 的 OpenGL 项 

28 gl.glEnable(GL10.GL DEPTH TEST); 

29 gl.glDepthFunc(GL10.GL LEQUAL); 

30 gl.glClearDepthf(1f); 

31 gl.glEnableClientState(GL10.GL VERTEX ARRAY); 

32 

33 // 设 置 透明 效果 

34 if (SEE THRU) { 


35 gl.glDisable(GL10.GL DEPTH TEST); 

36 gl.glEnable(GL10.GL BLEND); 

37 gl.glBlendFunc(GL10.GL SRC ALPHA, GL10.GL ONE); 
38 } 

39 


40 // 加 载 纹 理 贴图 

41 gl.glEnable(GL10.GL TEXTURE 2D); 

42 loadTexture(gl); 

43 } 

(D 第 9—19 行 定义 用 光 的 属性 ,包括 光源 、 环 境 光 、 漫 射 光 。 

Q 第 22 一 25 行 定义 立方 体 的 材质 。 

@ 第 34 一 38 行 定义 透明 效果 。 

CD 第 42 行 加 载 纹理 图 片 。 

省 略 二 : 这 部 分 省 略 的 代码 是 重 写 抽 象 方法 onSurfaceChanged()。 具 体 代 码 如 下 。 


1 public void onSurfaceChanged(GL10 gl, int width, int height) ( 
2 
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// 设 置 视 口 
gl.glViewport(0, 0, width, height); 


gl.glMatrixMode(GL10.GL PROJECTION); 


3 
4 
5 
6 // 设 置 当 前 矩阵 堆栈 为 投影 矩阵 ,并 将 矩阵 重 置 为 单位 矩阵 
7 
8 gl.glLoadIdentity(); 

9 


10 // 宽 高 比 

11 float aspect = (float) width / (float) (height == 0? 1 : height); 
12 GLU. gluPerspective(gl, 45.0f, aspect, 0.1f, 200.0f); 

13 // 设 置 投影 变换 矩阵 ,显示 稍 大 些 的 立方 体 

14 GLU.gluLookAt(gl, — 20f, — 20f, 20f, Of, Of, Of, 0, 0, 1); 

15 } 


(D 第 12 行 ,定义 一 个 透视 投影 变换 。gluPerspective() 是 Android OpenGL ES 的 GLU 
包 内 的 一 个 定义 透视 投影 变换 的 方法 ,其 格式 为 : 


GLU. gluPerspective(GL10 gl, float fovy, float aspect ,float zNear, float zFar) 


其 中 ,fovy 定义 视 锥 的 view angle: aspect 定义 视 锥 的 宽 高 比 ; z Near 定义 裁剪 面 的 近 间 
隔 ; zFar 定义 创建 面 的 远 间 隔 。 

© 第 14 行 ,设置 modelview 变换 矩阵 。gluLookAt() 是 Android OpenGL ES 的 GLU 包 
内 的 一 个 直观 的 设置 modelview 变换 矩阵 的 方法 ,其 格式 为 : 

GLU. gluLookAt(GL10 gl, float eyeX, float eyeY, float eyeZ, float centerX, float centerY, float 

centerZ, float upX, float upY, float upZ) 

其 中 ,eyeX,eyeY,eyeZ 指定 观测 点 的 空间 坐标 ; centerX  centerY ,centerZ 指定 被 观测 物 
体 的 参考 点 的 坐标 ; upX,upY,upZ 指定 观测 点 标的 目标 为 “上 ”的 向 量 。 

省 略 三 : 这 部 分 省 略 的 代码 是 重 写 抽象 方法 onDrawFrame ()。 具 体 代 码 如 下 。 


1 public void onDrawFrame(GL10 gl) { 


// 清 除 颜色 缓冲 
gl.glClear(GL10.GL COLOR BUFFER BIT | GL10.GL DEPTH BUFFER BIT); 


// 即 随后 的 矩阵 操作 将 应 用 到 要 绘制 的 模型 上 
gl. glMatrixMode(GL10.GL MODELVIEN); 


2 
3 
4 
5 // 设 置 当 前 矩阵 堆栈 为 模型 堆栈 ,并 重 置 堆栈 
6 
7 
8 gl.glLoadIdentity(); 


9 gl.glTranslatef(0, 0, -3.0£); 

10 

11 // 将 旋转 矩阵 应 用 到 当前 矩阵 堆栈 上 , 即 旋转 模型 

12 gl.glRotatef(anglez, 0, 0, 1); 

13 gl.glRotatef(angley, 0, 1, 0); 

14 gl.glRotatef(anglex, 1, 0, 0); 

15 anglex += 0.1; // 递 增 角度 值 以 便 每 次 以 不 同 角度 绘制 
16 angley += 0.2; 

17 anglez *- 0.3; 

18 

19 // 启 用 顶点 数组 ,法 向 量 、 纹 理 坐 标 数组 

20 gl.glEnableClientState(GL10.GL VERTEX ARRAY); 

2 gl.glEnableClientState(GL10.GL TEXTURE COORD ARRAY); 
22 


23 // 设 置 正面 
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gl.glFrontFace(GL10.GL CW); 


// 设 置顶 点 数组 指针 为 ByteBuffer 对 象 vertices 

// 第 一 个 参数 为 每 个 顶点 包含 的 数据 长 度 ( 以 第 二 个 参数 表示 的 数据 类 型 为 单位 ) 
gl.glVertexPointer(3, GL10.GL FLOAT, 0, vertices); 

gl.glTexCoordPointer(2, GL10.GL FLOAT, 0, tvertices); 

// 绑 定 纹理 

gl.glBindTexture(GL10.GL TEXTURE 2D, texture); 


// 绘 制 triangles 表示 的 三 角形 
gl.glDrawElements(GL10.GL TRIANGLES, triangles. remaining(), 
GL10.GL UNSIGNED BYTE, triangles); 


// 禁 用 顶点 法 向 量 、 纹 理 坐标 数组 
gl.glDisableClientState(GL10.GL VERTEX ARRAY); 
gl.glDisableClientState(GL10.GL TEXTURE COORD ARRAY); 


CD 58 8 fs Yt n E Per RON ERROR PIE o 
© 第 9 行 ,设置 移动 。 这 里 的 glTranslatef(0, 0, 一 3. 0D ;表示 将 视图 向 Z 轴 负 向 平移 


三 个 单位 。 


省 略 四 : 这 部 分 省 略 的 代码 是 定义 对 物体 贴 纹理 图 片 的 方法 loadTexture()。 具 体 代码 


如 下 。 


1 
2 
3 
4 
3 


private void loadTexture(GL10 gl) { 


InputStream bitmapStream = null; 
Bitmap bitmap = null; 
try{ 
bitmapStream = context. getResources( ). openRawResource(R. drawable. tree) ; 
// 从 图 资源 中 取 图 片 
bitmap = BitmapFactory.decodeStream(bitmapStream); 
// 从 流 中 加 载 并 解码 图 片 生成 Bitmap 对 象 


int[] textures = new int[1]; 
gl.glGenTextures(1, textures, 0); ”// 生 成 一 组 纹理 并 把 纹理 的 ID 存 人 数组 参数 中 


texture = textures[0]; 


gl.glBindTexture(GL10.GL TEXTURE 2D, texture); 
// 将 指定 ID 的 纹理 绑 定 到 指定 的 目标 中 去 


gl.glTexParameterf (GL10.GL TEXTURE 2D, GL10.GL TEXTURE MIN FILTER, GL10.GL NEAREST); 
gl.glTexParameterf (GL10.GL TEXTURE 2D, GL10.GL TEXTURE MAG FILTER, GL10.GL LINEAR); 


gl.glTexParameterf(GL10.GL TEXTURE 2D, GL10.GL TEXTURE WRAP S, GL10.GL REPEAT); 
gl.glTexParameterf(GL10.GL TEXTURE 2D, GL10.GL TEXTURE WRAP T, GL10.GL REPEAT); 


GLUtils.texImage2D(GL10.GL TEXTURE 2D, 0, bitmap, 0); 
// 将 Bitmap 对 象 设置 到 纹理 目录 中 


) finally { 
if (bitmap != null) 
bitmap. recycle(); 


if (bitmapStream !- null) 


27 try { 

28 bitmapStream.close(); 
29 } catch (IOException e) ( 

30 } 

31 } 

32] 


第 14 一 18 行 设 置 纹理 参数 ,这 里 设置 了 4 个 参数 : GL_ 
TEXTURE MIN FILTER 和 GL TEXTURE MAG FILTER 
指定 纹理 在 被 缩小 或 放大 时 使 用 的 过 滤 方 式 ，GL_LINEAR( 线 
性 插值 ) 要 比 GL NEAREST( 最 近 点 ) 效 果 好 ,但 前 者 需要 更 多 
的 运算 开销 ; GL. TEXTURE. WRAP S fll GL TEXTURE 
WRAP T 表 示 当 贴图 坐标 不 在 0. 0 — 1. 0 之 间 时 如 何 处 理 ， 
这 里 使 用 GL_REPEAT, 即 平 铺 贴图 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 3DCube_2 项 目 , 便 可 在 屏幕 上 看 到 一 个 自动 顺 时 针 旋转 的 
贴图 正方 体 ,如 图 8-3 所 示 。 

【案例 8.4】 设计 一 个 立体 多 面体 ,使 用 触 控 笔 可 以 旋转 
这 个 3D 图 形 。 

【说 明 】 本 例 在 3D 图 形 上 增加 了 触摸 功能 ,需要 在 
GLSurfaceView 对 象 上 添加 一 个 onTouchEvent() 的 回调 方 
法 。 本 例 的 重点 工作 仍 在 开发 逻辑 代码 上 。 

【开发 步骤 及 解析 】 
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图 8-3 一 个 自动 顺 时 针 旋转 的 
贴图 正方 体 


(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 3DGraphics 的 Android 项 目 。 其 应 用 程序 名 
为 3DTouch, 包 名 为 cn. com. sgmsc. OpenGL. Activity 组 件 名 为 OpenGLActivity。 
(2) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. OpenGL 包 下 的 OpenGLActivity. java X 


件 , 并 编辑 之 。 代 码 如 下 所 示 。 


1 package cn. com. sgmsc. OpenGL; 

2 

3 import android. app. Activity; 

4 import android. os. Bundle; 

5 

6 public class OpenGLActivity extends Activity ( 

7 MyGLSurfaceView myGLSurfaceView; // 自 定义 GLSurfaceView 
8 @Override 

9 public void onCreate(Bundle savedInstanceState) ( //Activity 创建 时 被 调用 
10 super. onCreate( savedInstanceState); 

1i myGLSurfaceView = new MyGLSurfaceView(this); // 创 建 一 个 自 定义 的 GLSurfaceView 
12 this. setContentView(myGLSurfaceView); // 设 置 当前 的 用 户 界 面 
13 myGLSurfaceView. requestFocus() ; // 获 得 焦点 

14 myGLSurfaceView. setFocusableInTouchMode(true);// 设 置 可 以 触 控 

15 } 


16 @override 
17 protected void onResune() ( 
18 super. onResume( ) ; 


19 if(myGLSurfaceView !- null)( // 当 nyGLSurfaceView 不 为 空 时 


20 myGLSurfaceView. onResume( ) ; 
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21 } 

22 } 

23 @Override 

24 protected void onPause()( 

25 super. onPause( ) ; 

26 if(myGLSurfaceView != null)( 
27 myGLSurfaceView. onPause( ) ; 
28 ] 

29 H 

30 ) 


// 当 myGLSurfaceView 不 为 空 时 


第 17—22 行 , 重 写 了 onResume() 方 法 ,第 24 一 29 行 重 写 了 onPause() 方 法 。 这 样 做 的 
目的 是 当 该 应 用 从 前 台 转 到 后 台 , 再 从 后 台 变 为 前 台 后 ,屏幕 上 的 3D 图 形 能 保持 先前 的 


(3) 开发 3D 效果 泻 染 器 及 触摸 操作 代码 。 在 src/cn. com. sgmsc. OpenGL 包 下 创建 一 
个 代码 文件 MyGLSurfaceView. java ,该 文件 是 定义 一 个 GLSurfaceView 子 类 ,在 这 里 定义 演 
染 器 MyRenderer, 它 继承 自 GLSurfaceView. Renderer。 其 代码 如 下 所 示 。 


package cn. com. sgnsc. OpenGL; 


import java. nio. ByteBuffer; 
import java. nio. ByteOrder; 


import javax. microedition. khronos. egl. EGLConf ig; 
import javax. microedition. khronos. opengles. GL10; 


1 
2 
3 
4 
5 import java. nio. IntBuffer; 
6 
7 
8 


import android. content. Context; 


9 import android. opengl.GLSurfaceView; 

10 import android. view. MotionEvent; 

11 

12 public class MyGLSurfaceView extends GLSurfaceView{ 

13 MyRenderer myRenderer; // 自 定义 的 泻 染 器 

14 private IntBuffer — nVertexBuffer; // 顶 点 坐标 数据 缓冲 

15 private IntBuffer mColorBuffer; // 顶 点 着 色 数据 缓冲 

16 private final float TOUCH_SCALE_FACTOR = 180.0f/320;// 角 度 缩放 比例 

17 private float nPreviousY; // 上 次 的 触 控 位 置 Y 坐 标 
18 private float nPreviousX; // 上 次 的 触 控 位 置 X 坐 标 
19 float yAngle = 0; // 绕 Y 轴 旋转 的 角度 

20 float zAngle - 0; // 绕 z 轴 旋转 的 角度 

21 int vertexCount; // 顶 点 的 个 数 

22 public MyGLSurfaceView(Context context)( // 构 造 器 

23 super(context); 

24 myRenderer - new MyRenderer(); // 创 建 泻 染 器 

25 this. setRenderer(myRenderer); // 设 置 泻 染 器 

26 this. setRenderMode(GLSurfaceView. RENDERMODE CONTINUOUSLY); // 设 置 泻 染 模式 
27 this. initVertexBuffer(); // 初 始 化 顶点 坐标 数组 
28 this. initColorBuffer(); // 初 始 化 颜色 数组 

29 ) 

30 (SOverride 

31 public boolean onTouchEvent(MotionEvent e)( // 触 摸 事 件 的 回调 方法 
32 float x = e.getX(); // 得 到 X 坐 标 

33 float y = e.getY(); // 得 到 Y 坐 标 

34 Switch (e.getAction()) ( 

35 case MotionEvent. ACTION MOVE: // 触 控 笔 移动 

36 float dy 7 y - nPreviousY; // 计 算 触 控 笔 了 位 移 
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37 float dx = x — mPreviousX; // 计 算 触 控 笔 x 位 移 
38 yAngle += dx * TOUCH SCALE FACTOR; // 设 置 沿 Y 轴 旋转 角度 
39 zAngle += dy * TOUCH SCALE FACTOR; // 设 置 沿 Z 轴 旋转 角度 
40 requestRender() ; // 重 绘画 面 

4l } 

42 mPreviousY = y; // 记 录 触 控 笔 位 置 

43 mPreviousX = x; // 记 录 触 控 笔 位 置 

44 return true;// 返 回 true 

45 ) 

46 private void initVertexBuffer()( // 初 始 化 顶点 坐标 数据 
47 //.…… 省 略 一 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 

48 } 

49 private void initColorBuffer(){// 初 始 化 颜色 数组 

50 //.…… 省 略 二 : 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 

51] 


52 // 自 定义 的 泻 染 器 
53 private class MyRenderer implements GLSurfaceView. Renderer{ 


@Override 
public void onDrawFrame(GL10 gl) { ET EA 
// 清 除 颜色 缓存 于 深度 缓存 
gl.glClear(GL10.GL COLOR BUFFER BIT|GL10.GL DEPTH BUFFER BIT); 


gl.glMatrixMode(GL10.GL MODELVIEN); // 设 置 当前 矩阵 为 模式 矩阵 


gl.glLoadIdentity(); // 设 置 当 前 矩阵 为 单位 矩阵 
gl.glTranslatef(0, Of, - 3f); 

gl.glRotatef(yAngle, 0, 1, 0); // 沿 Y 轴 旋转 
gl.glRotatef(zAngle, 0, 0, 1); // 沿 X 轴 旋转 


gl.glEnableClientState(GL10.GL VERTEX ARRAY); // 启 用 顶点 坐标 数组 
gl.glEnableClientState(GL10.GL COLOR ARRAY); // 启 用 顶点 颜色 数组 


9g1.glVertexPointer(// 为 画笔 指定 顶点 坐标 数据 
3, // 每 个 顶点 的 坐标 数量 为 3 xyz 


GL10.GL FIXED, // 顶 点 坐标 值 的 类 型 为 GL. FIXED 
0, mVertexBuffer // 顶 点 坐标 数据 
); 
gl. glColorPointer( // 为 画笔 指定 顶点 着 色 数 据 
4，// 设 置 颜色 的 组 成 成 分 , 必须 为 4 一 RGBA 
GL10.GL FIXED, // 顶 点 颜色 值 的 类 型 为 GL. FIXED 
0, mColorBuffer // 顶 点 着 色 数据 
); 
gl. glDrawArrays(GL10. GL_TRIANGLES, 0, vertexCount); // 绘 制图 形 
) 
@Override 
public void onSurfaceChanged(GL10 gl, int width, int height) { 
gl.glViewport(0, 0, width, height); // 设 置 视 窗 大 小 及 位 置 
gl.glMatrixMode(GL10.GL PROJECTION); // 设 置 当前 矩阵 为 投影 矩阵 
gl. glLoadIdentity(); // 设 置 当 前 矩阵 为 单位 矩阵 
float ratio = (float)width/height; // 计 算 透 视 投 影 的 比例 
gl.glFrustumf( - ratio, ratio, —1, 1, 1, 10); // 调 用 此 方法 计算 产生 透视 投影 矩阵 
H 
(GOverride 
public void onSurfaceCreated(GL10 gl, EGLConfig config) ( // 创 建 时 被 调用 
gl.glDisable(GL10.GL DITHER); // 关 闭 抗 抖动 
gl.glEnable(GL10.GL DEPTH TEST); // 启 用 深度 测试 
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第 30—45 行 , 重 写 了 onTouchEvent() 方 法 。 在 该 方法 中 定义 : 当 触 摸 笔 上 下 移动 时 , 物 
Mi Z 轴 旋 转 , 当 左右 移动 时 ,物体 沿 X 轴 旋 转 。 

接 下 来 对 省 略 的 部 分 代码 作 解 析 。 

省 略 一 : 这 部 分 省 略 的 代码 是 初始 化 顶点 坐标 数据 方法 initVertexBuffer()。 具 体 代 码 


如 下 。 
1 private void initVertexBuffer(){ // 初 始 化 顶点 坐标 数据 
2 vertexCount = 15; // 顶 点 的 个 数 
3 final int U=10000; // 创 建 像 素 单位 
4 int vertices[] = new int[]( 
5 0,0,0, 
6 -6*U,-6*U,0, 
7 -6*U,6*U,0, 
8 0,0,0, 
9 -6*U,6*U,0, 
10 0,12 * U,0, 
11 0,0,0, 
12 0,12 * U,0, 
13 6*U,6*U,0, 
14 0,0,0, 
15 6*U,6*U,0, 
16 6*U, -6*U,0, 
17 0,0,0, 
18 6*U, -6*U,0, 
19 -6*U,-6*U,0 
20 h 
21 // 创 建 顶点 坐标 数据 缓冲 
22 ByteBuffer vbb = ByteBuffer.allocateDirect(vertices. length* 4); 
23 vbb. order(ByteOrder. nativeOrder()); // 设 置 字 节 顺序 
24 mVertexBuffer = vbb.asIntBuffer(); // 转 换 为 int 型 缓冲 
25 mVertexBuffer. put (vertices); // 向 缓冲 区 中 放 入 顶点 坐标 数据 
26 mVertexBuffer. position(0); // 设 置 缓冲 区 起 始 位 置 
27) 


58 5.8,11,14,17 行 定义 5 个 顶点 的 坐标 ,它们 重合 在 坐标 原点 上 。 
省 略 二 : 这 部 分 省 略 的 代码 是 初始 化 颜色 数组 方法 initColorBuffer() 。 具 体 代码 如 下 。 


1 private void initColorBuffer(){ // 初 始 化 颜色 数组 
2 final int one = 65535; 

3 int colors[] = new int[]( // 顶 点 颜色 值 数组 ,每 个 顶点 4 个 色彩 值 RGBA 
4 one, one, 0,0, // 黄 色 

5 0,0, one, 0， // 蓝 色 

6 0,0,0ne,0, 

7 one, one, 0,0, 

8 0,0,0ne,0, 

9 0,0,0ne, 0, 

10 one, one, 0,0, 

11 0,0,0ne,0, 

12 0,0,0ne,0, 

13 one, one, 0,0, 

14 0,0,0ne,0, 

15 0,0,0ne,0, 

16 one, one, 0,0, 

17 0,0,0ne,0, 
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18 0,0,0ne,0, 

19 E 

20 // 创 建 顶点 着 色 数 据 缓冲 

21 ByteBuffer cbb = ByteBuffer.allocateDirect(colors. length 4) ; 

22 cbb. order(ByteOrder. nativeOrder()); // 设 置 字 节 顺序 

23 mColorBuffer = cbb.asIntBuffer(); // 转 换 为 int 型 缓冲 

24 mColorBuffer. put(colors); // 向 缓冲 区 中 放 入 顶点 着 色 数 据 
25 mColorBuffer. position(0); // 设 置 缓冲 区 起 始 位 置 

26 } 

第 4,7.10,13,16 行 定义 5 个 顶点 的 颜色 为 黄色 ,其 余 各 点 的 颜色 为 蓝 色 。 


DATAR] 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 3DGraphics 项 目 , 初 始 进入 界 
面 如 图 8-4 所 示 。 当 拖 动 了 3D 图 形 之 后 ,可 看 到 经 过 旋转 变形 的 图 形 , 如 图 8-5 所 示 。 


图 8-4 初始 进入 程序 时 的 图 形 图 8-5 ”经 过 拖 动 旋转 后 的 图 形 


8.2 动画 播放 


在 开发 用 户 界面 时 ,除了 使 用 控件 布局 ,或 使 用 2D、3D 图 形 外 ,还 可 以 使 用 动画 播放 来 提高 
用 户 的 体验 。 本 节 将 介绍 两 种 动画 播放 技术 : 帧 动画 (Frame Animation) 和 补 间 动 画 (Tween 
Animation) 。 

在 Android 中 定义 动画 , 既 可 以 使 用 XML 文件 进行 描述 ,也 可 以 使 用 Java 代码 编程 。 如 
果 使 用 XML 文件 描述 动画 ,其 XML 文件 存放 在 res/anim 目录 下 ,这 个 anim 目录 需要 用 户 
创建 。 本 书 推荐 使 用 XML 文件 定义 动画 ,因为 使 用 XML 文件 的 可 读 性 较 高 ,程序 开发 的 效 

下 面 分 别 来 介绍 两 个 动画 技术 及 其 使 用 方法 。 


8.2.1 帧 动画 
1. 帧 动画 简介 
帧 动画 是 连续 地 播放 一 系列 的 图 片 文件 ,形成 动画 。 它 是 比较 传统 的 动画 方式 ,形成 动画 
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的 主要 要 素 有 三 个 : 多 幅 图 片 .播放 顺序 和 持续 时 间 。 

帧 动画 用 到 类 AnimationDrawable, 这 个 类 包含 在 android. graphics. drawable 包 下 。 每 
个 帧 动画 都 是 一 个 AnimationDrawable 对 象 。 

如 果 在 XML 文件 中 定义 动画 ,其 常用 的 属性 如 表 8-5 所 示 。 


表 8-5 使 用 XML 描述 帧 动画 的 常用 属性 说 明 


标签 名 属 性 说 明 
<animation-list> android:oneshot: 如 果 设 置 为 true, 则 该 动 ”Frame Animation 的 根 标签 ,包含 车 
画 只 播放 一 次 ,然后 停止 在 最 后 一 帧 TA «item 
<item> android:drawable: 图 片 帧 的 引用 每 个 <item 之 标记 定义 一 个 图 片 
android:duration: 图 片 帧 的 停留 时 间 帧 ,其 中 包含 图 片 资 源 的 引用 等 
android:visible: 图 片 帧 是 否 可 见 属性 
2. 帧 动画 的 使 用 


使 用 帧 动画 进行 开发 需要 注意 的 是 ,如 果 程 序 一 启动 就 播放 动画 ,不 能 在 onCreate( ) 方 法 
中 调用 start() 方 法 ,而 要 在 onWindowFocusChanged() 方 法 中 调用 start() 方 法 。 下 面 通过 一 
个 案例 来 说 明 帧 动画 的 用 法 。 该 案例 是 通过 按钮 的 单 击 来 启动 一 个 动画 的 。 

【案例 8. 5】 使 用 Frame Animation 设计 一 个 能 循环 播放 小 狗 图 片 的 动画 ,该 动画 由 单 
击 按钮 启动 。 

[588] 按照 帧 动画 的 三 要 素 ,首先 需要 准备 一 组 图 片 ,并 且 最 好 这 些 图 片 的 尺寸 一 致 。 

【开发 步骤 及 解析 】 

(1) 准备 素材 。 收 集 并 整理 一 套图 片 ,将 其 尺寸 裁剪 一 致 ,按照 p01. png,p02. png… 的 规 
则 命名 。 

(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 FrameAnimation 的 Android 项 目 。 其 应 用 程序 
名 为 FAnimation, 包 名 为 cn. com. sgmsc. FAnimation, Activity 组 件 名 为 FAnimationActivity。 

CD 准备 图 片 。 将 准备 好 的 图 片 复制 到 res/drawable-mdpi 目录 中 。 

(4) 定义 动画 。 在 res 目录 下 新 建 一 个 anim 目录 ,并 在 该 目录 下 创建 一 个 名 为 frame 
ani, xml 文件 并 编写 动画 的 描述 代码 ,代码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 

2 <animation- list xmlns:android = "http://schemas. android. com/apk/res/android" 

3 android:oneshot = "false"> 

4 < item android:drawable = "@drawable/p01" 

5 android:duration = "1000" 

6 android:visible = "true" /> 

7 < item android:drawable = "(àdrawable/p02" 

8 android:duration = "1000" 


9 android:visible = "true"/» 

10 < item android:drawable = "(9 drawable/p03" 
11 android:duration = "1000" 

12 android:visible- "true"/» 

13 < item android:drawable = "(8 drawable/p04" 
14 android:duration = "1000" 

15 android:visible = "true"/» 


16 < item android:drawable = "@drawable/p05" 


17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 


android:duration = "1000" 
android:visible = "true"/» 

< item android:drawable = "@drawable/p06" 
android: duration = "1000" 
android: visible = "true" /> 

< item android: drawable = "@drawable/p07" 
android:duration = "1000" 
android:visible = "true" /> 

< item android:drawable = "@drawable/p08" 
android: duration = "1000" 
android: visible = "true" /> 

< item android:drawable = "@drawable/p09" 
android: duration = "1000" 
android: visible = "true" /> 

< item android:drawable = "@drawable/p10" 
android: duration = "1000" 
android:visible = "true"/> 

< item android:drawable = "@drawable/p11" 
android: duration = "1000" 
android: visible = "true" /> 

< item android:drawable = "@drawable/p12" 
android:duration = "1000" 
android:visible = "true" /> 

< item android:drawable = "@drawable/p13" 
android:duration = "1000" 
android:visible = "true" /> 

< item android:drawable = "@drawable/p14" 
android:duration = "1000" 
android:visible = "true" /> 

< item android:drawable = "@drawable/p15" 
android:duration = "1000" 
android: visible = "true" /> 

< item android:drawable = "@drawable/p16" 
android:duration = "1000" 
android:visible = "true" /> 

< item android:drawable = "@drawable/p17" 
android:duration = "1000" 
android:visible = "true" /> 

< item android:drawable = "@drawable/p18" 
android:duration = "1000" 
android: visible = "true" /> 


58 «/animation- list» 

(D 第 3 行 设置 动画 是 循环 播放 。 

@ 每 一 个 <item > 标签 里 设置 一 幅 图 的 播放 属性 ,包括 指定 图 片 的 文件 名 ,指定 图 片 播放 
时 间 是 停留 1s, 图 片 可 见 。 

(5) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,其 代码 如 下 所 示 。 


JAaouAwWDr 


<?xml version = "1.0" encoding = "utf - 8"?> 
< LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 


android:orientation = "vertical" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
> 


< ImageView 
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<! -- 声明 一 个 垂直 分 布 的 线性 布局 
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8 android:id- "@ + id/iv" 

9 android: background = "@anim/frame_ani" 

10 android: layout_width = "wrap_content" 

11 android:layout height = "wrap content" 

12 android:layout gravity - "center horizontal" 

13 / <! -一 声明 一 个 ImageView 对 象 ——» 
14 < Button 

15 android: id= "@ + id/btn" 

16 android:text = "开始 动画 " 

17 android:layout width- "fill parent" 

18 android:layout height = "wrap content" 

19 android:layout gravity = "center horizontal" 

20 /> <! -- 声明 一 个 Button 对 象 --> 


21 «/LinearLayout > 


第 9 行 设置 该 ImageView 控件 的 图 片 源 为 帧 动画 XML 文件 。 
(6) 开发 逻辑 代码 。 打 开 并 编辑 src/cn. com. sgmsc. Fanimation 包 下 的 文件 
FanimationActivity. java ,代码 如 下 所 示 o 


1 package cn. com. sgnsc. FAnimation; 

2 

3 import android. app. Activity; // 引 入 相关 类 

4 import android. graphics. drawable. AnimationDrawable; // 引 入 相关 类 

5 import android. os. Bundle; // 引 入 相关 类 

6 import android. view. View; // 引 入 相关 类 

7 import android. view. View. OnClickListener; // 引 入 相关 类 

8 import android. widget. Button; // 引 入 相关 类 

9 import android. widget. ImageView; // 引 入 相关 类 

10 

11 public class FAnimationActivity extends Activity { 

12 @Override 

13 public void onCreate(Bundle savedInstanceState) { // 重 写 onCreate() 方 法 
14 super. onCreate( savedInstanceState); 

15 setContentView(R. layout. main); 

16 Button btn = (Button)findViewById(R. id. btn); 

17 btn.setOnClickListener(new OnClickListener() ( // 为 按钮 设置 监听 器 
18 @Override 

19 public void onClick(View v) { // 重 写 onClick() 方 法 
20 ImageView iv = (ImageView)findViewById(R. id. iv); 

21 iv.setBackgroundResource(R.anim.frame ani); 

22 AnimationDrawable ad = (AnimationDrawable)iv.getBackground(); 
23 ad.start(); // 启 动 AnimationDrawable 
24 ) 

25 Di 

26 

27 } 


O 第 21 行 设置 iv 对 象 的 图 片 源 来 自 于 drawable-mdpi 目录 中 的 frame. ani. xml, 

© 第 22 行 创建 一 个 AnimationDrawable 对 象 ad, 第 23 行使 用 start() 方 法 启动 ad。 注 
意 ,在 onCreate() 方 法 内 不 能 直接 使 用 ad. start()。 这 里 的 start() 方 法 是 在 按钮 的 
OnClickListener 监听 内 的 onClick() 方 法 中 调用 的 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 FrameAnimation 项 目 。 单 击 
“开始 动画 ”按钮 后 ,在 屏幕 上 循环 播放 一 系列 的 图 片 ,如 图 8-6 所 示 。 
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图 8-6 播放 帧 动画 的 效果 图 


8.2.2 补 间 动画 
1. 补 间 动 画 简介 


补 间 动 画 是 通过 一 系列 的 指令 ,将 一 个 View 对 象 进行 位 置 . 尺 寸 .旋转 等 变换 ,形成 动 
画 。 这 个 View 对 象 可 以 是 一 幅 图 片 ,也 可 以 是 其 他 的 文本 按钮 等 可 视 对 象 。 补 间 动 画 涉 及 
的 类 有 Animation, AnimationSet ,这些 类 都 位 于 android. view. animation 包 下 。 

补 间 动画 也 可 以 在 res/anim 目录 中 的 XML 文件 里 进行 声明 定义 。 在 XML 文件 中 指定 
动画 使 用 何 种 变换 、 何 时 进行 变换 及 动画 持续 多 长 时 间 等 。 补 间 动 画 常用 的 标签 及 属性 如 
表 8-6 所 示 。 


表 8-6 使 用 XML 描述 补 间 动 画 的 常用 属性 说 明 


标签 名 属 性 说 有明 
<set> sharelnterpolator: 在 子 元 素 中 共享 插入 器 包含 其 他 动画 变换 的 容器 
<alpha> fromAlpha: 起 始 透明 度 | toAlpha: 终止 透明 度 We EE 
fromXScale; X 的 起 始 值 | toXScale: X 的 终止 值 
«scale fromYScale; Y 的 起 始 值 | toYScale; Y 的 终止 值 2 ee iode 
pivotX; 中 心 的 X 坐 标 pivotY: 中 心 的 Y 坐标 
实现 水 平 或 垂直 移动 ,以 “%” 
fromXDelta: X 起 始 位 置 | toXDelta: X 终止 位 置 结尾 代表 相对 于 自身 的 比例 ; 
<translate> 以 “%p” 结 尾 代表 相对 于 父 控 
fromYDelta: Y 起 始 位 置 | toYDelta: Y 终止 位 置 件 的 比例 ; 不 以 任何 后 级 结尾 
代表 绝对 值 
PN fromDegree; 开始 位 置 toDegree: 结束 位 置 实现 旋转 ,可 以 指定 旋转 定 
pivotX. 中 心 的 XX 坐标 | pivotY: POR YAR | 位 点 
=Interpolator> 无 插入 器 ,描述 变换 的 速度 曲线 


表 8-6 中 列 出 的 是 各 标签 特有 的 属性 ,在 这 些 标签 中 有 一 些 共 有 的 属性 ,如 表 8-7 所 示 。 
表 8-7 使 用 XML 描述 补 间 动 画 标签 的 常用 公共 属性 说 明 
属 性 说 B 
duration 变换 持续 的 时 间 , 以 毫秒 为 单位 
startOffset 变换 开始 的 时 间 , 以 毫秒 为 单位 


repeatCount 定义 该 动画 重复 的 次 数 
interpolator 为 每 个 子 标记 变换 设置 插入 器 ,系统 已 经 设置 好 一 些 插入 器 ,可 以 在 R. anim 包 下 找到 
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2. 补 间 动画 的 使 用 


在 使 用 XML 定义 补 间 动 画 时 ,所 有 的 变换 要 放 在 一 组 二 set 二 二 /set 二 标签 之 间 。 一 组 
二 set 记 过/set 二 标签 内 可 以 定义 多 个 变换 ,甚至 可 以 是 男 一 组 二 set 记 二 /set 二 标签 。 下 面 通 
过 一 个 案例 来 说 明 补 间 动画 的 用 法 。 

【案例 8. 6】 使 用 Tween Animation 设计 一 个 从 暗 到 亮 、 逐 渐 放 大 、 绕 中 心 旋 转 的 
Android 小 机 器 人 动画 ,并 且 可 以 动态 指定 ImageView 中 的 图 片 源 。 

【说 明 】 在 程序 中 使 用 两 个 按钮 为 ImageView 控件 动态 指定 图 片 源 。 

【开发 步骤 及 解析 】 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 TweenAnimation 的 Android 项 目 。 其 应 用 
程序 名 为 TAnimation, 包 名 为 cn. com. sgmsc.TAni,Activity 组 件 名 为 TAnimationActivity。 

(2) 准备 图 片 。 将 准备 好 的 图 片 复制 到 res/drawable-mdpi 目录 中 。 

(3) 定义 动画 。 在 res 目录 下 新 建 一 个 anim. 目录 ,并 在 该 目录 下 创建 一 个 名 为 tween 
ani. xml 的 文件 ,并 编写 动画 的 描述 代码 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf 一 8"?> 
2 «set xmlns:android = "http: //schemas. android. com/apk/res/android"> 


3 <! -- 透明 度 的 变换 --> 

4 «alpha 

5 android:fromAlpha = "0.0" 

6 android:toAlpha = "1.0" 

7 android:duration = "5000" 

8 /> 

9 <! -- 尺寸 的 变换 --> 

10 < scale 

11 android: interpolator = "@android:anim/accelerate_decelerate_interpolator" 
12 android: fromXScale = "0.0" 
13 android: toXScale = "1. 0" 

14 android: fromYScale = "0. 0" 
15 android: toYScale = "1.0" 

16 android:pivotX = "50$" 

17 android:pivotY = "50$" 

18 android: fillAfter = "false" 
19 android: duration = "9000" 
20 /> 


2 <!-- 位 置 的 变换 --> 


22 <translate 


23 android:fromXDelta - "30" 
24 android:toXDelta - "0" 

25 android:fromYDelta = "30" 
26 android:toYDelta - "0" 

27 android:duration = "10000" 
28 /> 


29 <! -- 旋转 变换 --> 


30 «rotate 


31 android: interpolator = "(android:anim/accelerate decelerate interpolator" 
32 android:fromDegrees = "0" 

33 android:toDegrees = " + 360" 

34 android:pivotX = "50 %" 


35 android:pivotY = "50%" 
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36 android: duration = "10000" 
37 /> 
38 </set> 


(D 58 2—38 fr EET — e — set bk AE. EAE VW E XT — alpha, — scale, 
—translate7 fll rotate774 个 变换 标签 。 
© $ 4—8 行 声明 了 一 个 设置 透明 度 变 换 的 标签 ,“0. 0 表示 不 透明 “1. 0” 表 示 完 全 


透明 。 


© 第 10 一 20 行 声明 了 一 个 尺寸 变换 标签 ,其 中 ,“0. 0 表示 大 小 为 0“1. 0 表示 大 小 为 原 


始 尺 寸 。 


(D 第 22 一 28 行 声明 了 一 个 位 置 变换 标签 。 
© 第 30—37 行 声明 了 一 个 旋转 变换 标签 。 旋 转 从 0" 顺 时 针 旋 转 360" , 
© 注意 ,每 一 种 变换 持续 的 时 间 设 置 ,一般 透 明度 变换 时 间 最 短 ,位 置 和 旋转 变换 持续 时 


间 最 长 。 


(4) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,其 代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android - "http://schemas. android. com/apk/res/android" 


w 


27 


32 
33 


android:orientation = "vertical" 

android:layout_width = "fill_parent" 

android:layout_height = "fill_parent" 

> <! -- 声明 一 个 垂直 分 布 的 线性 布局 --> 


< InageView 


android:id- "(9 + id/iv" 
android:src = "(à drawable/android01" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
/> <! -- 声明 一 个 ImageView 控件 --> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:orientation = "horizontal" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:gravity- "center horizontal" 
> <! -- 声明 一 个 垂直 分 布 的 线性 布局 --> 
<Button 
android:id- "(9 + id/btni" 
android: text = "图 片 1" 
android:layout width = "100px" 
android:layout height = "wrap content" 
android:layout marginRight = "10dip" 
/> <! -- 声明 一 个 Button 控件 --> 
< Button 
android:id- "(9 + id/btn2" 
android:text = "图 片 2" 
android:layout width = "100px" 
android:layout height = "wrap content" 
/> <! -- 声明 一 个 Button 控件 --> 
</LinearLayout > 


34 </LinearLayout > 


第 9 行 设置 ImageView 控件 的 图 片 源 。 注 意 ,使 用 Tween Animation 设计 动画 ,XML X 
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件 只 是 设置 动画 的 变换 属性 ,不 指定 图 片 来 源 ,因此 ,在 布局 文件 中 指定 图 片 源 必须 是 一 个 图 


片 资源 文件 。 
(5) 开发 逻辑 代码 。 打 开 并 编辑 src/cn. com. sgmsc. Tani 包 下 的 文件 TanimationActivity. 
java, 代 码 如 下 所 示 。 
1 package cn. com. sgnsc. TAni; 
2 
3 import android. app. Activity; // 引 入 相关 类 
4 import android. os. Bundle; // 引 入 相关 类 
5 import android. view. View; // 引 入 相关 类 
6 import android. view. View. OnClickListener; // 引 入 相关 类 
7 import android. view. animation. Animation; // 引 入 相关 类 
8 import android. view. animation. AnimationUtils; // 引 入 相关 类 
9 import android. widget. Button; // 引 入 相关 类 
10 import android. widget. ImageView; // 引 入 相关 类 


12 public class TAnimationActivity extends Activity { 
13 @Override 


14 public void onCreate(Bundle savedInstanceState) ( // 重 写 onCreate( ) 方 法 
15 super. onCreate(savedInstanceState); 

16 setContentView(R. layout. main); // 设 置 屏幕 

17 Button btnl = (Button)findViewById(R. id. btnl); // 获 取 Button X1 


18 btnl.setOnClickListener(new OnClickListener() ( 
// 为 Button 对 象 添 加 OnClickListener 监听 器 


19 (2 Override 

20 public void onClick(View v) ( // 重 写 onClick( ) 方 法 

21 ImageView iv = (ImageView)findViewById(R. id. iv); 

22 iv. setImageDrawable(getResources().getDrawable(R. drawable. android01)); 

23 Animation animation = AnimationUtils. loadAnimation (TAnimationActivity. this, R. 
anim.tween ani); 

24 iv.startAnimation(animation); // 启 动 动画 

25 } 

26 H; 

27 Button btn2 = (Button)findViewById(R. id. btn2); // 获 取 Button 对 象 


28 btn2. setOnClickListener(new OnClickListener() ( 
// 为 Button 对 象 添加 OnClickListener 监听 器 


29 (2 Override 

30 public void onClick(View v) ( // 重 写 onClick( ) 方 法 

31 ImageView iv = (ImageView)findViewById(R. id. iv); 

32 iv. setImageDrawable(getResources().getDrawable(R. drawable. android02)); 

33 Animation animation = AnimationUtils. loadAnimation(TAnimationActivity.this, 
R.anim.tween ani); 

34 iv.startAnimation(animation); // 启 动 动画 

35 } 

36 ] 

7 } 

38 ] 


创建 一 个 最 多 支持 三 个 流 同时 播放 的 , 且 类 型 标记 为 音乐 的 SoundPool 对 象 。 第 23,33 
行 ,设置 动画 的 变换 属性 来 源 于 tween_ani. xml 文件 中 所 定义 的 动画 属性 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 TweenAnimation 项 目 。 单 击 
“图 片 1" 按 钮 后 ,在 屏幕 上 播放 一 个 由 小 到 大 、 逐 渐 清 晰 的 顺 时 针 旋 转 的 图 片 , 如 图 8-7 所 示 。 
单 击 “ 图 片 2 按钮 后 ,在 屏幕 上 播放 相同 的 动画 ,只 是 这 时 的 图 片 不 同 ,如 图 8-8 所 示 。 
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图 8-8 ”播放 另 一 幅 图 的 补 间 动画 


8.3 ”音频 与 视频 播放 


在 应 用 中 ,适当 地 运用 音频 与 视频 的 播放 可 以 收 到 极 好 的 应 用 效果 。Android 系统 提供 
了 对 常见 格式 媒体 的 编码 .解码 机 制 , 可 以 容易 地 集成 音频 .视频 和 图 片 等 多 媒体 文件 到 
应 用 程序 中 ,例如 相册 ,播放 器 .录音 和 摄像 等 应 用 程序 。 当 然 , 有 些 应 用 需要 硬件 的 支持 。 

音频 和 视频 的 播放 常用 到 MediaPlayer 类 。 该 类 位 于 android. media 包 下 ,在 该 类 中 提供 
了 播放 ,暂停 .停止 和 重复 播放 等 方法 。 下 面 分 别 对 音频 、 视 频 的 播放 进行 介绍 。 


8.3.1 播放 音频 


Android 平台 中 播放 音频 有 两 种 方式 : 使 用 SoundPool 类 进行 播放 和 使 用 MediaPlayer 
类 进行 播放 ,它们 都 位 于 android. media 包 下 。 前 一 种 方式 适合 短促 且 对 反应 速度 比较 高 的 
清 况 (例如 播放 游戏 音效 或 按键 声 等 ) ,而 后 一 种 方式 适合 比较 长 且 对 时 间 要 求 不 高 的 情况 ( 例 
如 播放 后 台 音乐 .歌曲 等 )。Android 的 音频 文件 存放 在 项 目的 res/raw 目录 下 ,其 中 的 raw 
目录 需要 开发 者 自己 创建 。 

Android 支持 的 音频 格式 有 : OGG、MP3、MID、WAV、AMR 等 ,其 中 OGG 格式 性 能 最 
佳 。 音 频 格式 采样 率 分 别 为 1 1kHz、22kHz、44. 1kHz,16 位 立体 声 。 


1. 使 用 SoundPool 类 播放 音频 


使 用 SoundPool 类 播放 音频 的 步骤 如 下 。 
1) 创建 一 个 SoundPool 对 象 
创建 一 个 SoundPool 对 象 的 方法 为 


SoundPool(int maxStream, int streamType, int srcQuality) 


其 中 ,参数 maxStream ,指定 同时 播放 的 流 的 最 大 数量 ;参数 streamType, 指 定 流 的 类 型 ,一 般 
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为 STREAM_MUSIC( 具 体 的 流 类 型 在 AudioManager 类 中 列 出 ); 参 数 srcQuality, 指 定 采 样 
率 转化 质量 ,默认 值 为 0, 表示 不 指定 采样 率 转化 质量 。 

例如 ,创建 一 个 最 多 支持 三 个 流 同时 播放 的 , 且 类 型 标记 为 音乐 的 SoundPool 对 象 , 其 代 
码 如 下 。 


SoundPool soundPool = new SoundPool(3, AudioManager. STREAM MUSIC, 0); 


2) 加 载 音频 资源 

SoundPool 可 以 通过 load ) 方 法 来 加 载 一 个 音频 资源 ,load() 方 法 有 4 种 加 载 方式 ,分 别 
如 下 。 

CD 通过 一 个 AssetFileDescriptor 对 象 加 载 音频 : int load(AssetFileDescriptor afd, int 
priority) 。 

(2) 通过 一 个 资源 ID 加 载 音频 : int load(Context context, int resld, int priority) 。 

(3) 通过 指定 的 路 径 加 载 音频 : int load(String path. int priority). 

(4) 通过 FileDescriptor 加 载 音频 : int loadCFileDescriptor fd. long offset. long length. 
int priority) 。 

一 个 SoundPool 能 同时 管理 多 个 音频 ,所 以 可 以 通过 多 次 调用 load 函数 来 加 载 ,如 果 加 
载 成 功 将 返回 一 个 非 0 的 soundID, 用 于 播放 时 指定 特定 的 音频 。 一 般 把 多 个 声音 放 到 
HashMap 中 去 ,例如 创建 一 个 最 多 支持 三 个 流 同 时 播放 的 , 且 类 型 标记 为 音乐 的 SoundPool 
对 象 , 并 将 资源 中 的 dingdong. ogg 文件 以 优先 级 为 1 传人 HasMap 对 象 中 ,其 代码 段 如 下 。 

SoundPool soundPool = new SoundPool(3, AudioManager. STREAM MUSIC, 0); 

soundPoolMap = new HashMap(); 

soundPoolMap.put(1l, soundPool.load(this, R. raw. dingdong, 1)); ”// 将 资源 中 的 音频 文件 设 为 优先 级 1 

3) 播放 控制 

SoundPool 用 于 控制 音频 播放 的 常用 方法 如 表 8-8 所 示 。 

表 8-8 SoundPool 用 于 控制 音频 播放 的 常用 方法 及 说 明 
5 d 描 x 


playCint soundID, float leftVolume, 播放 指定 音频 的 音效 ,并 返回 一 个 streamID。 其 中 ,参数 priority 是 

float rightVolume, int priority, int 流 的 优先 级 , 值 越 大 优先 级 越 高 ,影响 当 同时 播放 数量 超出 了 最 大 支 

loop, float rate) 持 数 时 SoundPool 对 该 流 的 处 理 ; 参数 loop 是 循环 播放 的 次 数 , 一 1 
为 无 限 循环 ,其 他 值 为 播放 loop 十 1 次 ; 参数 rate 是 播放 的 速率 , 范 
围 为 0. 5 一 2. 0(0. 5 为 一 半 速 率 ,1. 0 为 正常 速率 ,2. 0 为 两 倍速 率 ) 


pause(int streamID) 暂停 指定 播放 流 的 音效 ,参数 streamID 是 play() 的 返回 值 ,以 毫秒 为 单位 
resume(int streamID) 继续 播放 指定 播放 流 的 音效 ,参数 streamID 是 play() 的 返回 值 
stop(int streamID) 终止 指定 播放 流 的 音效 ,参数 streamID 是 play() 的 返回 值 


setLoop(int streamID, int loop) 设置 指定 播放 流 的 循环 

setVolume (int streamID， float 设置 指定 播放 流 的 音量 

leftVolume, float rightVolume) 

setPriority(int streamID. int priority) ”设置 指定 播放 流 的 优先 级 

setRate(int streamID, float rate) 设置 指定 播放 流 的 速率 

unload(int soundID) 务 载 一 个 指定 的 音频 资源 , 印 载 成 功 返 回 true 


release() 释放 SoundPool 中 的 所 有 音频 资源 
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这 里 ,play() 方 法 传递 的 是 一 个 load() 返 回 的 soundID, 它 指向 一 个 被 记载 的 音频 资源 。 
同一 个 soundID 可 以 通过 多 次 调用 play() 而 获得 多 个 不 同 的 streamID, 当然 不 要 超出 同时 播 
放 的 最 大 数目 。pause() .resume() 和 stop() 方 法 是 针对 播放 流 操作 的 ,其 流 的 ID 来 自 于 play() 
的 返回 值 。 

在 API 中 指出 ,即使 调用 相关 的 方法 时 ,使 用 了 无 效 的 soundID /streamID 也 不 会 导致 错 
误 中 断 。 在 程序 退出 时 ,需要 终止 播放 并 释放 资源 。 


2. 使 用 MediaPlayer 类 播放 音频 


MediaPlayer 是 播放 媒体 文件 最 为 广泛 使 用 的 类 。MediaPlayer 可 以 用 来 播放 大 容量 的 
音频 文件 ,同时 也 可 支持 播放 操作 (停止 .开始 .暂停 等 ) 和 查找 操作 的 流 媒 体 , 它 还 可 支持 与 媒 
体操 作 相关 的 监听 器 。 

1) MediaPlayer 的 状态 

使 用 MediaPlayer 来 播放 音频 /视频 文件 或 流 的 控制 ,是 通过 一 个 状态 机 来 管理 实现 的 。 
一 个 MediaPlayer 对 象 刚 被 创建 或 被 重新 设置 时 ,处 于 idle 状态 ,处 于 idle 状态 的 
MediaPlayer 还 没有 设置 数据 源 ; 在 向 对 象 中 加 载 了 音频 /视频 资源 后 便 处 于 initialized 状态 ; 
当 对 象 调用 了 prepare() 方 法 后 ,对 象 便 处 于 prepare 状态 。 对 于 处 于 prepare 状态 的 对 象 就 
可 以 调用 start() 方 法 来 播放 音频 /视频 了 。 

2) 创建 MediaPlayer 对 象 

创建 MediaPlayer 对 象 可 以 使 用 两 种 方式 : 一 种 是 使 用 new MediaPlayer O , 另 一 种 是 使 
用 MediaPlayer. create...) 。 这 两 种 方法 创建 的 MediaPlayer 对 象 所 处 的 状态 是 不 同 的 ,下 面 
分 别 说 明 。 

使 用 new MediaPlayer CO 创建 对 象 后 , MediaPlayer 对 象 处 于 idle 状态 ,需要 调用 
setDataSource( ) 方法 为 对 象 加 载 音 频 资 源 , setDataSource () 支 持 从 path, URI 和 
FileDescriptor 三 种 途径 获取 音频 /视频 资源 ; 然后 还 需要 调用 prepare() 方 法 才能 进入 等 待 播 

使 用 create() 方 法 创建 MediaPlayer 对 象 后 ,MediaPlayer 对 象 随即 处 于 prepared RÆ, 
无 须 调 用 prepare() 方 法 ,否则 系统 会 报错 。 这 里 ,create() 方 法 支持 从 int(resID) 和 URI 两 种 
途径 获取 音频 /视频 资源 。 

MediaPlayer 对 象 对 播放 控制 的 方法 基本 上 与 SoundPool 类 中 的 相同 ,如 start O , pauseO , 
stop() ,seekToO .setLooping() 等 方法 。 需 要 注意 的 是 ,在 循环 播放 的 设置 上 与 SoundPool 
的 不 同 , 不 能 指定 确定 的 循环 次 数 ,而 是 一 个 布尔 值 ,指定 是 否 循环 播放 。 

3) MediaPlayer 监听 器 

对 MediaPlayer 对 象 可 以 定义 如 下 监听 器 : OnCompletionListener, OnPrepareListener, 
OnErrorListener, OnBufferingUpdateListener, OnInfoListener. OnVideoSizeChangedListener 
和 OnSeekCompleteListener 等 。 

如 果 要 在 播放 过 程 中 到 达 媒 体 源 末端 时 做 某 些 处 理 , 如 从 列表 中 播放 下 一 首 歌曲 或 释放 
媒体 播放 器 对 象 等 ,可 以 在 OnCompletionListener 监听 器 里 的 onCompletion (MediaPlayer 
mp) 事 件 中 进行 编码 。 如 果 在 准备 播放 媒体 源 时 需要 做 某 些 处 理 ,可 在 OnPrepareListener W 
听 器 的 onPrepared(MediaPlayer mp) 事 件 中 进行 编码 。 如 果 在 异步 操作 过 程 中 出 现 错误 时 
做 某 些 处 理 ( 其 他 错误 将 在 调用 方法 时 抛 出 异常 ), 可 在 OnErrorListener boolean onError 
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(MediaPlayer mp. int what. int extra) 事 件 中 进行 编码 ,这 里 ,参数 what 指明 了 已 发 生 错 误 
的 类 型 , 它 可 能 为 MEDIA ERROR UNKNOWN 或 MEDIA_ERROR_SERVER_DIED。 参 
数 extra 指明 了 与 错误 相关 的 附加 信息 。 


3. 播放 音频 案例 


【案例 8.7】 使 用 mediaplayer 和 soundpool 分 别 播放 mid 和 ogg 音频 文件 ,并 可 实现 两 
音频 可 以 同时 播放 。 

【说 明 〗 所 有 音频 文件 放 在 项 目的 res/raw 目录 下 ,这 个 raw 必须 开发 者 自己 创建 ,但 目 
录 名 必须 是 raw。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 AudioPlay 的 Android 项 目 。 其 应 用 程序 名 
为 AudioPlay, 包 名 为 cn. com. sgmsc. AuPlay, Activity 组 件 名 为 AudioPlayActivity。 

(2) 准备 音频 资源 。 在 项 目的 res 中 新 建 目录 raw ,并 将 backsound. mid fil dingdong. ogg 
音频 文件 复制 到 本 项 目的 res/raw 目录 中 。 

(3) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf 一 8"?> 


2 «LinearLayout xmlns:android = "http://schemas.android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 > 

7 < TextView 

8 android: id= "(à + id/textView" 

9 android:layout width- "fill parent" 
10 android:layout height = "wrap content" 
it android: text = "没有 播放 任何 声音 " 

12 /> 

13 < Button 

14 android: id= "(9 + id/button1" 

15 android: layout_width = "wrap content" 
16 android:layout height = "wrap content" 
17 android: text = "使 用 MediaPlayer 播放 声音 " 
18 /> 

19 « Button 

20 android:id- "(9 * id/button2" 

21 android:layout width- "wrap content" 
22 android:layout height = "wrap content" 
23 android:text = "暂停 MediaPlayer 声音 " 
24 /> 

25 < Button 

26 android: id= "@ + id/button3" 

27 android:layout width- "wrap content" 
28 android:layout height = "wrap content" 
29 android:text = "使 用 SoundPool 播放 声音 " 
30 /> 

31 <Button 

32 android:id- "(9 + id/button4" 

33 android:layout width- "wrap content" 


34 android:layout height = "wrap content" 
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35 android:text = "暂停 SoundPool 声音 " 
36 /> 
37 </LinearLayout > 


(OD 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. AuPlay 包 下 的 AudioPlayActivity. java X 


件 , 并 编辑 之 。 代 码 如 下 所 示 。 


package cn. con. sgnsc. AuPlay; 


x 
2 
3 import java. util. HashMap; 

4 import android. app. Activity; 

5 import android. content. Context; 

6 import android. media. AudioManager; 

7 import android. media. MediaPlayer; 

8 import android. media. SoundPool; 

9 import android. os. Bundle; 

10 import android. view. View; 

11 import android. view. View. OnClickListener; 
12 import android. widget. Button; 

13 import android. widget. TextView; 


14 

15 public class AudioPlayActivity extends Activity implements OnClickListener( 

16 Button buttoni; //4 个 按钮 的 引用 

17 Button button2; 

18 Button button3; 

19 Button button; 

20 TextView textView; //TextView 的 引用 

21 MediaPlayer mMediaPlayer; 

22 SoundPool soundPool; / /SoundPoo1 声音 

23 HashMap < Integer, Integer > soundPoolMap; 

24 / ** Called when the activity is first created. * / 

25 @Override 

26 public void onCreate( Bundle savedInstanceState) { // 重 写 onCreate( ) 回 调 方 法 
27 super. onCreate(savedInstanceState); 

28 initSounds(); // 初 始 化 声音 

29 setContentView(R. layout. main); // 设 置 显示 的 用 户 界 面 
30 textView = (TextView) this.findViewById(R. id.textView);  // 得 到 TextView 的 引用 
31 buttonl = (Button) this. findViewById(R. id. buttonl); // 得 到 button 的 引用 
32 button2 = (Button) this. findViewById(R. id. button2); 

33 button3 = (Button) this. findViewById(R. id. button3); 

34 button4 = (Button) this. findViewById(R. id. button4); 

35 buttoni. setOnClickListener(this); // 为 4 个 按钮 添加 监听 
36 button2. setOnClickListener(this); 

k yi button3. setOnClickListener(this); 

38 button4. setOnClickListener(this); 

39 } 

40 

41 public void initSounds()( // 初 始 化 声音 的 方法 
42 /* 初始 化 MediaPlayer 对 象 */ 

43 mMediaPlayer = MediaPlayer.create(this, R.raw.thesamesong); 

44 /* 初始化 SoundPool 对 象 * / 

45 soundPool = new SoundPool(4, AudioManager. STREAM MUSIC, 100); 

46 soundPoolMap = new HashMap < Integer, Integer»(); 

47 soundPoolMap. put(1, soundPool.load(this, R. raw. dingdong, 1)); 
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49 public void onClick(View v) { // 实 现 接口 中 的 方法 

50 if(v == buttoni)( // 单 击 了 “使 用 MediaPlayer 播放 声音 "按钮 
51 textView. setText(" 使 用 MediaPlayer 播放 声音 "); 

52 if(!mMediaPlayer. isPlaying())( 

53 nMediaPlayer. start(); // 播 放声 音 

54 } 

55 } 

56 else if(v == button2){ // 单 击 了 “暂停 MediaPlayer 声音 ”按钮 
57 textView. setText(" 暂 停 了 MediaPlayer 播放 的 声音 "); 

58 if(mMediaPlayer. isPlaying()){ 

59 nMediaPlayer. pause() ; // 暂 停 声音 

60 H 

61 } 

62 else if(v == button3){ // 单 击 了 “使 用 SoundPool 播放 声音 ”按钮 
63 textView. setText(" 使 用 SoundPool 播放 声音 "); 

64 this. playSound(1, 0); 

65 } 

66 else if(v == button4){ // 单 击 了 “暂停 SoundPool 声音 ”按钮 
67 textView. setText(" 暂 停 了 SoundPool 播放 的 声音 "); 

68 soundPool. pause(1); // 暂 停 SoundPool 的 声音 

69 } 

70 } 

71 / * 用 SoundPoll 播放 声音 的 方法 * / 

72 public void playSound( int sound，int loop) { 

73 AudioManager mgr = (AudioManager)this. getSystemService(Context. AUDIO SERVICE); 
74 float streamVolumeCurrent = mgr.getStreamVolume(AudioManager.STREAM MUSIC); 
75 float streamVolumeMax - mgr.getStreamMaxVolume(AudioManager. STREAM MUSIC); 
76 float volume = streamVolumeCurrent/streamVolumeMax; 

77 /* 播放 声音 * / 

78 soundPool. play(soundPoolMap.get(sound), volume, volume, 1, loop, 1f); 

79 ) 

80 } 


(D 第 15 行 ,定义 该 类 时 使 用 了 一 个 外 部 OnClickListener 监听 器 接口 。 这 么 做 的 目的 
是 ,可 以 在 一 个 onClick() 方 法 中 同时 定义 多 个 按钮 的 响应 动作 。 第 49 一 70 行 是 定义 4 个 按 
钮 的 响应 操作 代码 。 

© 第 41 一 48 行 ,分 别 用 MediaPlay 和 SoundPool 两 种 方式 初始 化 声音 方法 。 由 于 这 里 
的 SoundPool 对 象 最 多 支持 4 个 流 同时 播放 ,所 以 需要 创 
建 一 个 HashMap 来 存放 多 个 音频 文件 。 RE 

© 585 72 — 79 行 , 定 义 了 使 用 SoundPoll 播放 声音 的 
方法 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 


使 用 SoundPool 扬 放声 间 
运行 AudioPlay 项 目 , 其 运行 界面 如 图 8-9 所 示 。 按 照 按钮 


上 显示 的 含义 , 单 击 按钮 即 会 执行 相应 的 音频 控制 操作 。 
8.8.2 播放 视频 图 8-9 AudioPlay 项 目的 运行 界面 


Android 中 播放 视频 可 以 通过 两 种 方式 来 实现 。 一 种 是 通过 VideoView 组 件 , 该 种 方式 
实现 起 来 比较 简单 容易 ,但 是 其 可 控 性 不 强 , 可 以 完成 简单 的 播放 任务 ; 另 一 种 是 通过 
MediaPlayer 在 SurfaceView 进行 播放 ,该 种 方式 实现 起 来 比较 麻烦 ,但 是 可 控 性 极 强 。 所 以 
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在 实际 的 项 目 中 可 以 根据 不 同 的 需求 进行 使 用 。 
Android 支持 的 视频 格式 有 : mp4(MPEG-4 低 比 特 率 )、3gp、avi、flv、h. 263、h. 264Cavc) 
等 ,h.264 HE h. 263 在 相同 体积 下 画 质 更 好 。 一 般 地 ,比较 大 的 文件 都 存放 在 SD 卡 中 。 


1. 使 用 VideoView 播放 视频 


VideoView 类 位 于 android. widget 包 下 , 它 是 Android 自 带 的 .专业 化 的 显示 视频 的 视图 
控件 , 它 可 压缩 创建 并 初始 化 MediaPlayer。VideoView 类 可 从 各 种 源 ( 如 资源 或 内 容 提供 者 ) 
加 载 视频 ,并 且 可 负责 从 该 视频 计算 其 尺寸 ,以 便 其 可 在 任何 布局 管理 器 中 使 用 。 同 样 ,该 类 
还 可 提供 各 种 显示 选项 ,如 缩放 比例 和 着 色 ,可 用 来 显示 SDCard FileSystem 中 存在 的 视频 文 
件 或 联机 存在 的 文件 。 

使 用 VideoView 播放 视频 ,首先 ,需要 在 XML 文件 中 加 入 VideoView 控件 ,然后 从 SD 
Card 中 载 人 mp4 文件 或 3gp 文件 ,就 可 以 播放 视频 了 。 

例如 ,在 把 文件 beargolf. 3gp RAAI SD 卡 中 后 ,使 用 VideoView 显示 视频 的 简单 播放 控 
制 应 用 的 代码 片段 如 下 。 

XML 代码 


<VideoView 
android: id= "(à + id/vv" 
android:layout width = "320px" 
android:layout height = "240px"/» 
< Linearlayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:orientation = "horizontal" > 
« Button 
android:id- "@ + id/vv playbtn" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "播放 "/> 
< Button 
android:id- "@ + id/vv stopbtn" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "暂停 "/> 
</LinearLayout > 


vv = (VideoView) findViewById(R. id. vv); // 得 到 VideoView 对 象 vv 
vv playbtn- (Button)findViewById(R. id. vv_playbtn); 
vv stopbtn- (Button)findViewById(R. id.vv stopbtn); 


vv. setVideoURI(Uri. parse("sdcard/beargolf.3gp")); // 从 SD 卡 中 加 载 视频 文件 
vv. setMediaController(new MediaController(VvPlay.this)); // 创 建 媒 体 控制 器 
vv. requestFocus( ) ; //NideoView X4 & vv 获得 焦点 


vv playbtn. setOnClickListener(new OnClickListener()( 
public void onClick(View v) 
t 
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vv. start(); // 开 始 播放 视频 
i 
ni 
vv stopbtn. setOnClickListener(new OnClickListener()( 
public void onClick(View v) 
t 


vv. pause() ; // 暂 停 播放 视频 
} 
D; 
从 代码 中 可 以 看 到 ,使 用 VideoView 播放 视频 比较 简单 。MediaController 还 提供 了 播 
放 、 暂 停 、 滑 块 等 功能 。 虽 然 VideoView 可 以 很 容易 地 播放 视频 ,但 播放 位 置 和 播放 大 小 并 不 
受 控制 ,因此 ,可 使 用 SurfaceView 来 更 好 地 控制 播放 视频 。 


2. 使 用 MediaPlayer 和 SurfaceView 播放 视频 


MediaPlayer 主要 用 于 播放 音频 , 它 没 有 提供 输出 图 像 的 输出 界面 ,这 时 必须 用 到 
SurfaceView 控件 ,将 它 与 MediaPlayer 结合 起 来 ,就 能 达到 视频 的 输出 。SurfaceView 类 位 
于 android. view fJ F. SurfaceView 常用 的 方法 如 表 8-9 所 示 。 


表 8-9 SurfaceView 常用 的 方法 及 说 明 


5 d 描 g 
getHolder() 得 到 一 个 SurfaceHolder 对 象 来 管理 SurfaceView。 返 回 值 是 一 个 SurfaceHolder 对 象 
setVisibility(int ”设置 是 否 可 见 ,visibility 取 值 可 以 是 VISIBLE, INVISIBLE, GONE. iX J& % it f d 
visibility) 义 是 : 


。 View. VISIBLE, 常 量 值 为 0, 意思 是 可 见 的 。 
。 View.INVISIBLE, 常 量 值 是 4, 意思 是 不 可 见 的 。 
* View. GONE, 常 量 值 是 8, 意 思 是 不 可 见 的 ,并 且 不 占用 布局 空间 


SurfaceHolder 是 一 个 接口 ,用 于 管理 SurfaceView, SurfaceHolder 类 也 位 于 android. 
view 包 下 , 它 有 两 个 常用 的 内 部 接口 SurfaceHolder. Callback 和 SurfaceHolder. Callback2. 
Callback2 是 实现 于 Callback 的 。SurfaceHolder. Callback 接口 类 用 于 接收 预览 界面 变化 的 
信息 ,可 通过 重 写 以 下 三 个 抽象 方法 来 实现 。 

当 SurfaceView 创建 时 触发 : 


public abstract void surfaceCreated( SurfaceHolder holder); 

当 SurfaceView 改变 (如 预览 界面 的 格式 和 大 小 发 生 改变 ) 时 触发 : 

public abstract void surfaceChanged(SurfaceHolder holder, int format, int width, int height); 
当 SurfaceView 销毁 时 触发 : 

public abstract void surfaceDestroyed(SurfaceHolder holder); 


使 用 MediaPlayer 和 SurfaceView 的 实现 步骤 如 下 。 

(1) 创建 MediaPlayer 对 象 ,并 设置 加 载 的 视频 文件 (使 用 setDataSource() 方 法 ) 。 

(2) 在 界面 布局 文件 中 定义 SurfaceView 控件 。 

(3) 通过 MediaPlayer. setDisplay ( SurfaceHolder sh) 来 指定 视频 画面 输出 到 SurfaceView 
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Pm 

(4) 通过 MediaPlayer 的 其 他 一 些 方法 用 于 播放 视频 。 

下 面 通过 一 个 视频 播放 案例 来 说 明 其 用 法 。 

【案例 8.8】 使 用 MediaPlayer 和 SurfaceView 播放 一 个 存放 在 SD 上 的 视频 文件 ,并 可 
以 控制 视频 的 播放 和 暂停 。 

【说 明 】 在 第 7 章 中 曾 介绍 过 在 模拟 器 中 使 用 SD 卡 的 用 法 ,在 这 里 简单 回顾 一 下 。 使 
用 SD 卡 中 的 文件 有 以 下 4 个 步骤 。 

CD 创建 一 个 SD 卡 镜像 文件 myvideo. img。 在 命令 行 提示 状态 下 输入 命令 : 


mksdcard 1024M E:\3gms\myvideo. img 

(2) 关联 SD 卡 和 模拟 器 。 在 Eclipse 中 ,启动 模拟 器 ,然后 选择 菜单 Window > 
Preferences 进入 Preferences 对 话 框 ,在 type filter text 中 选择 Android Launch. fE £131 fff 
Default emulator options :编辑 框 中 输入 “-sdcard e:\4gms\myvideo. img”, 设 置 模拟 器 默认 的 
启动 参数 ,如 图 8-10 所 示 。 


1 Preferences E 
type filter text Launch ST 

General ^. | Launch Settings: 

Android , ; 
i Default emulator options: -sdcard e\3gms\myvideo.img| 
DDMS Default HOME package: — android.process.acore 
Editors 
Launch 

8-10 设置 模拟 器 默认 的 启动 参数 
关联 SD 卡 和 模拟 器 。 


(3) 向 SD 卡 中 导入 文件 。 在 Eclipse ff] DDMS 的 FileExplorer 中 ,选择 sdcard, 单 击 
push 按钮 导入 ,如 图 8-11 所 示 。 然 后 从 指定 的 文件 夹 中 打开 需要 的 视频 文件 (本 例 的 项 目 所 
在 文件 夹 是 e:\3gmsN\Ch08\VideoPlay ,视频 文件 名 为 beargolf. 3gp) 。 


E! Debug & Java [B DOMS] 


FE Es Eis] 


A E Ed] 
i. Permis. Info (Bush a file onto the device 


图 8-11 Eclipse 中 DDMS 的 File Explorer 


COD 在 模拟 器 中 使 用 SD 卡 中 的 文件 。 使 用 setDataSource("/sdcard/beargolf. 3gp") 方 法 
将 模拟 器 的 SD 卡 中 的 文件 载 人 MediaPlayer 对 象 中 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 VideoPlay 的 Android 项 目 。 其 应 用 程序 名 
为 VideoPlay, 包 名 为 cn. com. sgmsc. VPlay. Activity 组 件 名 为 VideoPlayActivity。 
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(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,在 其 中 需要 设置 一 个 SurfaceView 
控件 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 
2 «LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 


28 


android:orientation = "vertical" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
> < -- 添加 一 个 垂直 的 线性 布局 --> 
< SurfaceView 
android:id- "@ + id/surfaceView" 
android:layout width = "320px" 
android:layout height = "240px" 
人 > <! -一 添加 一 个 SurfaceView 用 于 播放 视频 --> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
E <! 一 -添加 一 个 线性 布局 --» 
<Button 
android:id- "(à + id/play2 Button" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: text = "播放 " 
^ < -- 添加 一 个 按钮 --> 
< Button 
android: id = "@ + id/pause2 Button" 
androijd:layout_width = "wrap content" 
android:layout height = "wrap content" 
android:text = "暂停 " 
/> < -- 添加 一 个 按钮 --> 


</LinearLayout > 


29 </LinearLayout > 


(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Vplay 包 下 的 VideoPlayActivity. java XX 
件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgnsc. VPlay; 


import android. app. Activity; 

import android. graphics.PixelFormat; 
import android. media. AudioManager; 

import android. media. MediaPlayer; 

import android. os. Bundle; 

import android. view. SurfaceHolder; 

import android. view. SurfaceView; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 


public class VideoPlayActivity extends Activity implements OnClickListener, SurfaceHolder. Callback( 
String path = "/sdcard/beargolf.3gp"; 

Button play Button; 

Button pause Button; 

boolean isPause = false; 

SurfaceView surfaceView; 
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20 SurfaceHolder surfaceHolder; 
21 MediaPlayer mediaPlayer; 
22 public void onCreate(Bundle savedInstanceState) ( 


23 super. onCreate(savedInstanceState); 

24 setContentView(R. layout.main); 

25 play Button = (Button) findViewById(R. id.play2 Button); 

26 play Button. setOnClickListener(this); 

27 pause Button = (Button) findViewById(R. id.pause2 Button); 

28 pause Button. setOnClickListener(this); 

29 getWindow().setFormat(PixelFormat. UNKNOWN) ; 

30 surfaceView = (SurfaceView) findViewById(R. id. surfaceView); 

31 surfaceHolder = surfaceView.getHolder(); 

32 surfaceHolder. addCallback(this); 

33 surfaceHolder. setFixedSize(176,144); 

34 surfaceHolder. setType(SurfaceHolder. SURFACE TYPE PUSH BUFFERS); 
35 mediaPlayer = new MediaPlayer(); 

36 ) 

37 public void onClick(View v) ( 

38 if(v == play Button)( // 单 击 “播放 ”按钮 

39 isPause = false; 

40 playVideo(path); 

41 ) 

42 else if(v == pause Button)( // 单 击 “ 暂 停 ” 按 钮 

43 if(isPause == false){ // 如 果 正 在 播放 则 将 其 暂停 
44 mediaPlayer. pause( ) ; 

45 isPause = true; 

46 } 

47 else( // 如 果 暂 停 中 将 继续 播放 
48 mediaPlayer.start(); 

49 isPause - false; 

50 } 

51 } 

52 } 

53 private void playVideo(String strPath){ // 自 定义 播放 影片 函数 
54 if(mediaPlayer. isPlaying() == true)( 

55 mediaPlayer.reset(); 

56 ) 

57 mediaPlayer.setAudioStreamType(AudioManager. STREAM MUSIC) ; 

58 mediaPlayer. setDisplay(surfaceHolder); / [i 'R Video 影片 以 SurfaceHolder 播放 
59 try{ 

60 mediaPlayer. setDataSource(strPath); 

61 mediaPlayer.prepare(); 

62 ) 

63 catch (Exception e)( 

64 e. printStackTrace(); 

65 } 

66 nediaPlayer.start(); 

67} 


68 public void surfaceChanged(SurfaceHolder arg0, int argl, int arg2, int arg3) (] 
69 public void surfaceCreated(SurfaceHolder arg0) {} 
70 public void surfaceDestroyed(SurfaceHolder arg0) (] 


n} 


(D 第 14 行 ,定义 VideoPlayActivity 类 实现 两 个 接口 : OnClickListener 和 SurfaceHolder. 
Callback, 
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加 第 15 行 ,将 SD 卡 中 文件 的 路 径 赋 予 字符 串 变量 path 中 。 

@ 第 29 行 ,getWindow(). setFormat(PixelFormat. UNKNOWN) 方 法 是 允许 Android 
对 窗口 显示 格式 进行 其 他 设置 。 在 编写 视频 播放 程序 中 这 是 非常 关键 的 处 理 。 

@ 第 32 行 ,surfaceHolder. addCallback(this) ,为 surfaceHolder 对 象 添加 回调 方法 。 

@ 第 33 行 ,通过 surface 的 holder 设置 显示 尺寸 。 

© 第 34 行 ,设置 显示 类 型 ,参数 SURFACE_TYPE_PUSH_BUFFERS 是 一 系统 定义 的 
int 型 常量 ,表示 SurfaceView 本 身 不 包含 数据 源 , 其 数据 来 源 于 其 他 对 象 。 

© 第 53 一 67 行 定义 了 playVideo() 方 法 。 其 中 ,第 54 一 56 行 是 设置 当 视频 正在 播放 时 
将 mediaPlayer 对 象 初始 化 ; 第 57 行 是 设置 音频 为 流 类 型 ; 
第 58 行 是 设置 画面 的 输出 对 象 ; 第 61 行 设置 播放 视频 文件 
的 数据 源 ; 第 62 行 设置 mediaPlayer 对 象 处 于 prepare 状态 ; 
第 66 行 设置 开始 播放 视频 。 

(& 5$ 68—70 行 是 重 写 SurfaceHolder. Callback 接口 的 
三 个 抽象 方法 ,在 这 里 并 没有 定义 具体 代码 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 
行 VideoPlay 项 目 , 单 击 “ 播 放 ” 按 钮 即 可 以 看 到 视频 ,同时 可 
听 到 视频 的 配音 , 单 击 “ 和 暂停” 按钮 可 暂停 视频 的 播放 ; 如 果 正 
在 播放 时 再 单 击 “ 播 放 ” 按 钮 ,视频 将 从 头 开 始 播 放 。 其 运行 — 图 8-12 能 控制 播放 或 暂停 
界面 如 图 8-12 所 示 。 视频 播放 器 


6.4 声音 与 图 像 数据 采集 


8.4.1 声音 采集 


Android 的 声音 采集 ( 即 录音 ) 可 使 用 MediaRecorder 类 来 实现 。MediaRecorder 类 位 于 
android. media 包 下 , 它 包含 Audio 和 Video 的 记录 功能 。 

使 用 MediaRecorder 录制 的 语音 文件 格式 通常 为 . amr, 录 制 的 文件 一 般 都 是 保存 在 SD 
卡 中 。 使 用 MediaRecorder 进行 录音 通常 需要 编写 下 列 代码 段 。 


MediaRecorder recorder = new MediaRecorder(); // 创 建 一 个 MediaRecorder X $& recorder 
recorder. setAudioSource( MediaRecorder. AudioSource. MIC) ; // 设 置 麦克 风 

recorder. setOutputFormat(MediaRecorder.OutputFormat. THREE GPP); // 设 置 输出 格式 
recorder. sethudioEncoder(MediaRecorder.AudioEncoder.AMR NB); // 设 置 音 频 编码 Encoder? 
recorder. setOutputFile("/sdcard/myrec/myrecord01.amr"); // 设 置 音频 文件 保存 路 径 
recorder. start() ; // 开 始 录制 


注意 ,录音 操作 需要 拥有 录音 权限 和 对 存储 卡 的 写 人 权限 。 所 以 一 定 要 记 住 ,在 编写 
录音 的 应 用 程序 时 ,要 在 AndroidManifest. xml 文件 的 “二 manifest 二 ”标签 内 加 入 下 列 权 限 
代码 。 


< uses - permission android:name = "android. permission. RECORD AUDIO"/> 
< uses - permission android:name = "android. permission. WRITE EXTERNAL STORAGE" /> 


下 面 通过 一 个 实用 案例 来 说 明 录 音程 序 的 设计 。 
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【案例 8.9】 使 用 VoiceRecord 类 实现 一 个 录音 器 ,该 录音 器 可 以 进行 录音 、 停 止 .播放 、 
删除 功能 , 且 将 录制 的 文件 存放 在 SD 卡 中 。 

[588] 使 用 SD 卡 保存 录制 的 文件 ,首先 在 移动 设备 (手机 或 模拟 器 ) 上 要 有 SD 卡 。 判 
断 设备 中 是 否 有 SD 卡 ,使 用 下 列 方法 : 


Environment. getExternalStorageState(). equals(android. os. Environment. MEDIA MOUNTED) 


如 果 返 回 的 值 为 true, 则 设备 上 存在 SD 卡 ,否则 没有 SD 卡 。 

【开发 步骤 及 解析 】 

CD 用 户 界面 设计 。 在 屏幕 的 上 端 并 排放 置 4 个 按钮 ,分 别 执行 录音 、 停 止 \ 播 放 、 删 除 的 
监听 操作 。 在 屏幕 的 下 部 用 一 个 列表 列 出 已 录制 的 声音 文件 ,在 按钮 和 列表 之 间 是 一 行文 本 
用 于 显示 当前 的 声音 文件 。 使 用 背景 色 来 划分 分 区 。 

(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 VoiceRecord 的 Android 项 目 。 其 应 用 程序 
名 为 VoiceRecord, 包 名 为 cn. com. sgmsc. VR. Activity 组件 名 为 VoiceRecActivity。 

(3) 准备 图 片 。 将 用 于 图 片 按钮 的 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目录 中 。 

(4) 创建 颜色 资源 。 创 建 并 编写 res/values 目录 下 的 颜色 描述 文件 color. xml, 代 码 如 下 
所 示 。 


1 <?xml version= "1.0" encoding = "utf 一 8"?> 

2 <resources> 

3 <color name = "black"» i FF000000 </color > 

4 <color name = "lightpurple"» £ FFbdb2e6 </color > 
5 <color name = "white"># FFFFFFFF </color > 

6 </resources> 


(5) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 o 


1 <?xml version = "1.0" encoding = "utf - 8"?» 

2 <LinearLayout 

xmlns:android = "http://schemas. android. com/apk/res/android" 
4 android:orientation = "vertical" 

5 android:layout width = "fill parent" 

6 android:layout height - "fill parent" 

7 android: background = "@color/lightpurple"> 

8 


< LinearLayout 
9 android: id= "(9 + id/LinearLayout01" 
10 android: layout_width = "wrap content" 
11 android:layout height = "wrap_content"> 
12 < ImageButton 
13 android: id = "(à + id/ImageButton01" 
14 android:layout width = "wrap content" 
15 android: layout_height = "wrap_content" 
16 android: src = "@drawable/record"> 
17 </ImageButton > 
18 < ImageButton 
19 android: id = "@ + id/ImageButton02" 
20 android:layout width = "wrap content" 
21 android:layout height = "wrap content" 
22 android: src = "(Qdrawable/stop"» 
23 </ImageButton> 


24 < ImageButton 
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25 android: id = "(9 + id/ImageButton03" 

26 android:layout width = "wrap content" 
27 android:layout height = "wrap content" 
28 android: src = " (2 drawable/play"» 

29 «/InageButton? 

30 < ImageButton 

31 android: id = "(9 + id/ImageButton04" 

32 android:layout width = "wrap content" 
33 android:layout height = "wrap content" 
34 android: src = "(9 drawable/delete"» 

35 </ImageButton > 


36 </LinearLayout > 
37  «TextView 


38 android: id= "@ + id/TextView01" 

39 android: layout width= "wrap content" 
40 android:layout height = "wrap content" 
4l android:textColor = "(Qcolor/black"» 


42  «/TextView» 
43  «ListView 


44 android: id= "(9 + id/ListView01" 

45 android:layout width = "wrap content" 
46 android:layout height = "wrap content" 
47 android:background = "@color/black"> 


48 </ListView> 
49 </LinearLayout > 


(6) 设计 ListView 的 条 目 布局 。 编 写 res/layout 目录 下 的 my_list_item. xml 文件 ,代码 
如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf 一 8"?> 

2 < CheckedTextView 

3 xmlns:android = "http://schemas.android. con/apk/res/android" 
android:id- "(9 + id/myCheckedTextViewl" 

android:layout width- "fill parent" 

android:layout height = "fill parent" 

android:textColor = "(Qcolor/white" /» 


2005 


这 个 xml 文件 中 只 定义 了 一 个 CheckedTextView 控件 。CheckedTextView 类 继承 TextView 
并 实现 Checkable 接口 。 

CD 开发 逻辑 代码 : 打开 src/cn. com. sgmsc. VR 包 下 的 VoiceRecActivity. java 文件 ,并 
编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgnsc. VR; 


E 
2 
3 import java. io. File; 

4 import java. io. IOException; 

5 import java. util. ArrayList; 

6 import android. app. Activity; 

7 import android. content. Intent; 

8 import android. media. MediaRecorder; 
9 import android. net. Uri; 

10 import android. os. Bundle; 

11 import android. os. Environment; 

12 import android. view. View; 

13 import android. widget. AdapterView; 
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import android. widget. ArrayAdapter; 
import android. widget. CheckedTextView; 
import android. widget. ImageButton; 
import android. widget. ListView; 

import android. widget. TextView; 

import android. widget. Toast; 


public class VoiceRecActivity extends Activity 
private ImageButton myButtonl; 
private ImageButton myButton2; 
private ImageButton myButton3; 
private ImageButton myButton4; 
private ListView myListViewl; 
private String strTempFile - "voice "; 
private File myRecAudioFile; 
private File myRecAudioDir; 
private File myPlayFile; 
private MediaRecorder mMediaRecorder; 
private ArrayList < String» recordFiles; 
private ArrayAdapter < String > adapter; 
private TextView myTextViewl; 
private boolean sdCardExit; 
private boolean isStopRecord; 


(QOverride 

public void onCreate(Bundle savedInstanceState)( 
super. onCreate( savedInstanceState); 
setContentView(R. layout. main); 


myButtonl = (ImageButton) findViewById(R. id. ImageButton01); 
myButton2 - (ImageButton) findViewById(R. id. ImageButton02); 
myButton3 = (ImageButton) findViewById(R. id. ImageButton03); 
myButton4 = (ImageButton) findViewById(R. id. InageButton04); 
myListViewl - (ListView) findViewById(R. id.ListView01); 
myTextViewl - (TextView) findViewById(R. id. TextView01); 
myButton2.setEnabled(false); 

myButton3. setEnabled(false); 

myButton4. setEnabled(false); 


/* 判断 SD Card 是 否 插入 * / 

sdCardExit = Environment. getExternalStorageState().equals( 
android. os. Environment.MEDIA MOUNTED); 

/ * 取得 SD Card 路 径 作为 录音 的 文件 位 置 * / 

if (sdCardExit) 
myRechudioDir = Environment. getExternalStorageDirectory(); 


/* 取得 SD Card 目录 里 的 所 有 .amr 文 件 * / 
getRecordFiles(); 


adapter = new ArrayAdapter < String >(this, 

R. layout. my_list_item, recordFiles); 
/* 将 ArrayAdapter 添加 到 ListView 对 象 中 */ 
myListViewl.setAdapter(adapter); 


/* 录音 */ 
myButtonl.setOnClickListener(new ImageButton. OnClickListener()( 
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70 //.…… 省 略 一 : 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
71 DE 

72 

73 /x Bab x/ 

74 myButton2.setOnClickListener(new ImageButton. OnClickListener()( 
75 11... BEL: 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
76 Di 

"1 

78 /* 播放 */ 

79 nyButton3.setOnClickListener(new ImageButton. OnClickListener()( 
80 //…… 和 省 略 三 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
81 D 

82 

83 /* 删除 * / 

84 myButton4. setOnClickListener(new ImageButton. OnClickListener()( 
85 //.…… 省 略 四 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
86 H: 

87 

88 myListViewl. setOnItemClickListener( 

89 new AdapterView. OnItemClickListener( ){ 

90 @Override 

91 public void onItemClick(AdapterView<?>arg0, View argl, 

92 int arg2, long arg3){ 

93 /* 当 单 击 列表 中 的 文件 名 时 将 “删除 ”及 “播放 ”按钮 置 为 Enable * / 
94 myButton3. setEnabled( true); 

95 myButton4. setEnabled(true); 

96 myPlayFile = new File(myRecAudioDir. getAbsolutePath() 

97 * File.separator 

98 * ((CheckedTextView) argl).getText()); 

99 myTextViewl. setText(" 你 选 的 是 :" 

100 + ((CheckedTextView) argl).getText()); 

101 ) 

102 ni 

103 } 

104 


105  (ZOverride 

106 protected void onStop()( 

107 if (mMediaRecorder != null && ! isStopRecord)( 
108 /* 停止 录音 */ 


109 mMediaRecorder. stop(); 
110 mMediaRecorder. release(); 
311 mMediaRecorder = null; 
112 } 

113  super.onStop(); 

1M } 

115 


116 /* 向 ArrayList 对 象 中 添加 SD 卡 中 的 .amr 文 件 名 * / 

117 private void getRecordFiles()( 

118 — //…… 省 略 五 : 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
119 } 

120 

121 /* 打开 播放 录音 文件 的 程序 */ 

122 private void openFile(File f) ( 

123 //.…… 省 略 六 : 省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
124 ] 
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125 

126 } 

(D 98 54. 58 行 判 断 外 部 存储 设备 SD 卡 是 否 插入 设备 中 。 其 中 android. os. 
Environment, MEDIA MOUNTED 是 系统 环境 常量 ,表示 SD 卡 已 插入 。 方 法 Environment. 
getExternalStorageDirectory( ) 的 功能 是 取 SD 卡 上 保存 文件 的 所 在 路 径 。 这 里 ,用 变量 
myRecAudioDir 保存 这 个 路 径 ,以便 后 面 用 于 保存 录音 文件 时 使 用 。 

© 第 63 一 66 行 实例 化 一 个 ArrayAdapter 对 象 adapter 并 设置 ,其 数据 源 由 自 定义 的 
getRecordFiles() 取 出 ,并 赋值 到 一 个 ArrayList 对 象 recordFiles 中 。getRecordFiles() 方 法 
的 代码 稍 后 解析 。 

© 第 88 一 103 行 定义 ListView 的 条 目 被 单 击 的 监听 器 。ListView 条 目 列 出 的 是 录音 文 
件 的 文件 名 , A ListView 中 的 文件 名 时 ,“ 播 放 ” 及 “删除 ”按钮 置 为 Enable。new File 
(myRecAudioDir. getAbsolutePath() 是 获取 保存 文件 的 路 径 , File. separator 是 获得 文件 路 径 
的 字符 ,((CheckedTextView) argl). getText() 是 获得 文件 的 文件 名 。 

@ 58 106—114 行 定义 了 onStop() 方 法 。 在 该 方法 内 停止 录音 ,并 释放 MediaRecorder 
对 象 。 接 下 来 对 省 略 的 部 分 代码 作 解 析 。 

省 略 一 : 这 部 分 省 略 的 代码 是 定义 “录音 ”按钮 的 单 击 监听 。 具 体 代 码 如 下 。 


1 /x 录音 */ 

2  myButtonl.setOnClickListener(new ImageButton. OnClickListener()( 

3 (GOverride 

4 public void onClick(View arg0)( 

5 try{ 

6 if (!sdCardExit){ 

2? Toast. nakeText(VoiceRecActivity.this, "请 插入 SD Card", 

8 Toast.LENGTH LONG).show(); 

9 return; 

10 } 

11 

12 /* 创建 录音 频 文件 * / 

13 myRecAudioFile = File.createTempFile(strTempFile, ".amr", myRecAudioDir); 
14 mMediaRecorder = new MediaRecorder(); 

15 /* 设置 录音 来 源 为 麦克 风 * / 

16 mMediaRecorder. setAudioSource(MediaRecorder. AudioSource. MIC); 
17 mMediaRecorder. setOutputFormat (MediaRecorder. OutputFormat. DEFAULT) ; 
18 mMediaRecorder. setAudioEncoder(MediaRecorder. AudioEncoder. DEFAULT) ; 
19 mMediaRecorder. setOutputFile(myRechudioFile. getAbsolutePath()); 
20 mMediaRecorder. prepare() ; 

21 mMediaRecorder. start(); 

22 myTextViewl.setText("3& EF"); 

23 myButton2. setEnabled(true); 

24 myButton3. setEnabled(false); 

25 myButton4. setEnabled(false); 

26 isStopRecord - false; 

27 } 

28 catch (IOException e){ 

29 e. printStackTrace(); 

30 } 

31 } 
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(D 第 6 一 10 行 是 判断 是 否 插入 了 SD 卡 ,如 果 没有 插入 SD 卡 就 给 出 提示 并 返回 ,退出 录 
THE, 

© 第 13 行 通过 createTempFile() 得 到 一 个 录制 文件 的 文件 名 。 这 个 文件 名 以 voice. s. 
amr 命名 ,文件 路 径 为 变量 myRecAudioDir 指定 的 值 。 该 方法 的 格式 为 : 


createTempFile(String prefix, String suffix, File directory) 


其 功能 是 在 指定 目录 directory 中 创建 一 个 新 的 空 文件 ,其 中 ,参数 directory 是 指定 的 目 
录 路 径 , 文 件 名 由 给 定 的 前 缀 prefix 和 后 级 suffix 字符 串 生 成 ,前 级 和 后 缀 之 间 由 任意 产生 的 
一 组 数据 构成 ,以 便 区 分 由 该 方法 产生 的 其 他 文件 名 。 

© 第 16~21 行 设置 录音 的 来 源 , 格 式 、 音 频 编码 、 音 频 文件 保存 路 径 , 设 置 完成 后 开始 录 
制 操作 。 

@ 58 23—25 行 设置 按钮 的 可 用 状态 。 

省 略 二 省略 三 省 略 四 : 这 部 分 省 略 的 代码 是 定义 按钮 “停止 ”*“ 播 放 ” 和 “删除 ”的 监听 
器 。 具 体 代码 如 下 。 


1 /x 停止 */ 

2 myButton2.setOnClickListener(new ImageButton. OnClickListener()( 
3 @Override 

4 public void onClick(View arg0)( 

5 if (myRecAudioFile != null)( 

6 /* 停止 录音 */ 

7 mMediaRecorder. stop(); 

8 mMediaRecorder. release(); 

9 mMediaRecorder = null; 

10 /* 将 音频 文件 名 给 Adapter * / 

11 adapter. add( myRecAudioFile. getName( ) ) ; 

12 myTextViewl. setText(" 停 止 : ”+ myRecAudioFile. getName() ); 
13 myButton2. setEnabled(false); 

14 isStopRecord = true; 

15 } 

16 } 

17 }); 

18 

19 /* 播放 * / 


20 myButton3.setOnClickListener(new ImageButton. OnClickListener()( 
21  (SOverride 

22 public void onClick(View arg0)( 

23 if (myPlayFile !- null && myPlayFile. exists())í 

24 /* 打开 播放 的 程序 * / 

25 openFile(myPlayFile); 


30/* 删除 * / 

31 myButton4. setOnClickListener(new ImageButton. OnClickListener()( 
32  (SOverride 

33 public void onClick(View arg0)( 

34 if (myPlayFile != null)( 

35 /* 先 将 Adapter 删除 文件 名 * / 

36 adapter. remove(myPlayFile.getName()); 

37 /* 删除 文件 * / 
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38 if (myPlayFile.exists()) 

39 myPlayFile.delete(); 

40 myTextViewl. setText(" 完 成 删除 "); 
4l / * 判断 adapter 为 空 时 按钮 的 状态 * / 
42 if (adapter. isEmpty()){ 

43 myButton3. setEnabled(false); 
44 myButton4. setEnabled(false); 
45 h 

46 ) 

47 j 

48 p 

49 


(D 第 7 一 9 行 ,如 果 正 在 录音 , 则 停止 录音 并 释放 MediaRecorder 对 象 。 第 11,12 行 是 从 
适配器 中 取出 当前 的 音频 文件 名 ,并 在 TextView 对 象 中 显示 停止 信息 。 
@ 第 23 一 25 行 设置 ,如 果 文 件 存在 , 则 播放 音频 文件 。 方 法 openFile() 是 打开 指定 的 文 
件 , 即 播放 指定 文件 。 
@ 第 36 行 是 删除 适配器 中 指定 的 数据 条 目 ; 第 39 行 删除 文件 ; 第 42 一 45 行 是 根据 
adapter 中 的 状态 来 确定 按钮 的 可 用 状态 。 
省 略 五 的 代码 定义 了 getRecordFiles() 方 法 ,省 略 六 的 代码 定义 了 播放 音频 的 播放 对 话 
具体 代码 如 下 。 
/ * 向 ArrayList 对 象 中 添加 SD 卡 中 的 .amr 文件 名 * / 
private void getRecordFiles(){ 
recordFiles = new ArrayList < String»(); 


1 
2 
3 
4 if (sdCardExit)( 

5 File files[] = myRecAudioDir.listFiles(); 
6 

7 

8 


框 


if (files != null)( 
for (inti = 0; i< files. length; i++){ 
if (files[i].getName(). indexOf£(".") >= 0){ 
9 /* 只 取 .amr 文 件 * / 
10 String fileS = files[i].getName().substring(files[i].getName(). indexOf(".")); 
11 if (fileS. toLowerCase(). equals(". amr" )) 
12 recordFiles.add(files[i].getName()); 


19 /* 打开 播放 录音 文件 的 程序 * / 

20 private void openFile(File f) { 

21 Intent intent = new Intent(); 

22  intent.addFlags(Intent.FLAG ACTIVITY NEW TASK); 

23  intent.setAction(android. content. Intent. ACTION VIEW); 
24 intent. setDataAndType(Uri. fromFile(f), "audio/ * "); 

25  startActivity(intent); 

26 } 

27 


CD 第 5 行 得 到 一 个 文件 型 的 数组 。myRecAudioDir. listFiles() 是 获得 指定 路 径 中 的 文件 
列表 。 
© $ 10 £7 . files i]. getNameO. substring(files[i]. getName().indexOf(".")) 获 得 文件 
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1、12 行 ,将 扩展 名 为 *. amr” 的 文件 加 入 到 recordFiles 中 ,recordFiles 是 


ArrayList 对 象 。 
® 第 20~26 行 ,打开 一 个 音频 播放 的 进度 条 对 话 框 。 
(8) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml, 添 加 权限 ,其 代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 «manifest xmlns:android = "http: //schemas. android. com/apk/res/android" 


19 
20 


package 7 "cn. con. sgnsc. VR" 
android:versionCode = "1" 
android:versionName = "1. 0. 0"> 
< application 
android: icon = "(2 drawable/icon" 
android: label = "@string/app_name"> 
X activity android:name = ".VoiceRecActivity" 
android: label = "(Qstring/app name"» 
< intent - filter > 
<action 
android:name = "android. intent. action. MAIN" /> 
< category 
android:name = "android. intent. category. LAUNCHER" /> 
</intent - filter > 
</activity> 
</application> 
< uses - permission android:name = "android. permission. RECORD AUDIO"/» 
< uses - permission android:name = "android. permission. WRITE EXTERNAL STORAGE" /> 


21 «/nanifest» 


(D 第 19 行 添加 录音 权限 。 
© 第 20 行 添加 存储 卡 的 可 写 人 权限 。 


【运行 结果 】 


-个 


在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 VoiceRecord 项 目 。 初 始 运行 


项 目 时 ,只 有 “录音 ”按钮 可 用 。 单 击 “ 录 音 ”, 开 始 录制 声音 ; 单 击 “ 停 止 ”, 即 停止 录音 ,并 按 指 
定 的 文件 名 前 组 ,后 组 形成 文件 名 ,以 列表 的 方式 显示 出 文件 名 ,如 图 8-13 所 示 。 选 择 该 文件 
名 列表 中 的 一 文件 名 ,即刻 在 列表 的 上 方 出 现 选中 项 的 信息 ,并 且 * 播 放 ? 或 "删除 ?按钮 呈 可 用 状 
态 。 此 时 ,可 执行 “播放 ?或 “删除 ?操作 ,例如 , 单 击 * 播 放 ” 按 钮 , 则 开始 播放 声音 ,如 图 8-14 所 示 。 


图 8-13 已 录制 了 4 个 音频 文件 图 8-14 正在 播放 第 二 个 音频 文件 


第 8 章 多 媒体 应 用 开发 


8.4.2? ”图像 采集 


Android 的 图 像 采集 可 以 用 两 种 实现 方式 ,一 是 利用 手机 自 带 的 Camera 应 用 程序 ; 二 是 
使 用 Camera 类 获得 摄像 头 信息 。 一 般 情 况 下 ,采集 的 图 像 文件 都 会 保存 在 存储 卡 上 ,因此 ， 
需要 在 AndroidManifest. xml 中 添加 存储 卡 可 写 权 限 , 即 在 二 manifest 过 标签 内 增加 权限 
代码 : 


<uses - permission android:name = "android. permission. WRITE EXTERNAL STORAGE" /> 


请 注意 ,Android 的 模拟 器 不 支持 Camera 拍照 的 图 像 显示 ,而 只 是 会 在 显示 区 出 现 网 格 ， 
以 表示 模拟 器 的 Camera 被 初始 化 了 ,拍照 后 获得 的 图 像 会 用 一 张 系统 内 部 的 图 片 代替 显示 。 
而 在 真 机 上 ,对 摄像 头 的 应 用 就 能 正常 显示 ,不 会 出 现 模拟 器 中 的 这 种 问题 。 因 此 ,开发 的 这 
类 应 用 ,必须 在 真 机 上 进行 测试 。 


1. 利用 手机 自 带 的 Camera 


每 个 Android 手机 都 有 一 个 自 带 的 Camera 应 用 程序 ,可 以 实现 一 般 的 拍照 功能 。 程 序 
员 可 以 在 自己 的 应 用 中 直接 调用 系统 自 带 的 Camera 应 用 程序 来 完成 图 像 采集 功能 。 下 面 通 
过 一 个 案例 来 说 明 如 何 使 用 手机 自 带 的 Camera 开发 图 像 采 集 应 用 。 

【案例 8.10】 通过 一 个 简单 界面 调用 模拟 器 内 置 的 Camera 应 用 程序 实现 拍照 应 用 。 

【说 明 】 通过 用 户 界面 的 一 个 按钮 来 调用 Android 自 带 的 Camera 应 用 程序 ,与 拍照 相 
关 的 调节 操作 由 Camera 应 用 程序 完成 。 拍 照 完毕 后 ,向 用 户 界面 返回 照片 。 

当 用 户 界面 调用 系统 应 用 时 ,该 用 户 的 Activity 将 会 转 信 后台, 而 当 Camera 应 用 完毕 后 ,用 
户 的 Activity 将 重新 被 激活 。 因 为 用 户 的 Activity 在 其 后 台 期 间 , 有 可 能 会 因 系 统 内 存 吃紧 被 销 
毁 , 所 以 在 程序 中 需要 使 用 生命 周期 方法 onSaveInstanceState() 和 onRestoreInstanceState() 来 保 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 AndCamera 的 Android 项 目 。 其 应 用 程序 名 
为 And_Camera, 包 名 为 cn. com. sgmsc. andcamera, Activity 组 件 名 为 AndCameraActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,这 是 一 个 用 户 自己 定义 的 界 
面 ,用 于 启动 Android 的 自 带 Camera 程序 和 显示 使 用 自 带 Camera 程序 拍摄 的 照片 ; 当 自 带 
Camera 程序 退出 时 ,该 界面 又 处 于 活动 状态 。 代 码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 


2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:gravity- "center horizontal|center vertical" 

7 

8 «RelativeLayout android:layout width- "fill parent" 

9 android:layout height = "wrap content" 

10 android:layout weight - "6" 

di android:gravity = "center horizontal|center vertical"» 
42 


13 < TextView android: id = "(9 + id/field" 
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14 android: layout_width= "fill parent" 

15 android:layout height = "wrap content" 
16 android:text = "No Image" 

17 android:gravity = "center horizontal"/» 
18 

19 < ImageView android: id= "@ + id/image" 

20 android:layout width = "fill parent" 

21 android:layout height = "wrap content"/» 
22 

23 «/RelativeLayout > 

24 

25 < Button android:id- "(9 + id/button" 

26 android:layout width- "fill parent" 

27 android:layout height = "wrap content" 

28 android:text = "Take Photo" 

29 android:layout weight = "1"/» 


30 «/LinearLayout » 


O 58 6 行 设 置 水 平 居中 和 垂直 居中 。 如 果 为 一 个 属性 设置 多 个 值 ,可 以 用 “| " 作 分 隔 符 。 

@ 在 一 RelativeLayout 二 布局 中 定义 了 两 个 控件 TextView 和 ImageView ,在 代码 中 没有 
设置 这 两 个 控件 的 相对 位 置 ,那么 它们 都 位 于 RelativeLayout 布局 的 中 央 。 在 Java 代码 中 要 
控制 二 者 的 可 见 或 隐藏 状态 。 

(D 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. andcamera 包 下 的 AndCameraActivity. 
java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. andcamera; 


2 
2 
3 import java. io. File; 

4 import android. app. Activity; 

5 import android. content. Intent; 

6 import android. graphics. Bitmap; 

7 import android. graphics. BitmapFactory; 
8 import android. net. Uri; 

9 import android. os. Bundle; 

10 import android. os. Environment; 

11 import android. provider. MediaStore; 

12 import android. view. View; 

13 import android. widget. Button; 

14 import android. widget. ImageView; 

15 import android. widget. TextView; 


17 public class AndCameraActivity extends Activity { 
18 protected Button u_button; 

19 protected ImageView u_image; 

20 protected TextView u_field; 


21 protected String u_path; // 拍 照 后 ,保存 文件 的 文件 全 名 
22 protected boolean u taken; // 拍 照 操作 的 状态 

23 protected static final String PHOTO TAKEN = "photo taken"; 

24 


25 (2Override 

26 public void onCreate(Bundle savedInstanceState) { 

27 super. onCreate(savedInstanceState); 

28 /* 设 定 屏 幕 显示 为 横向 */ 

29 this. setRequestedOrientation(0); // 设 置 纵向 显示 为 : setRequestedOrientation(90) 


30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
7i 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
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setContentView(R. layout. main); 


u image = ( ImageView ) findViewById( R. id. image ); 

u field = ( TextView ) findViewById( R. id. field); 

u button = ( Button ) findViewById( R. id. button ); 

u button. setOnClickListener( new ButtonClickHandler() ); 

/* 图 片 文件 路 径 * / 

u path = Environment.getExternalStorageDirectory() + "/take picture. jpg"; 


public class ButtonClickHandler implements View. OnClickListener { 
public void onClick( View view ){ 

File file = newFile( u path ); 
Uri outputFileUri = Uri.fromFile( file); 
/* 使 用 Android 自 带 的 Camera 捕捉 图 像 程序 * / 
Intent intent = new Intent(android. provider.MediaStore. ACTION IMAGE CAPTURE ); 
intent. putExtra( MediaStore. EXTRA OUTPUT, outputFileUri ); 
startActivityForResult( intent, 0 ); 


(QOverride 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
Switch( resultCode ) ( 


case 0: 
break; 
case -1: 
onPhotoTaken() ; // 显 示 捕获 的 照片 
break; 
} 
} 
/* 显示 捕获 的 照片 * / 


protected void onPhotoTaken() { 
u taken = true; 
BitmapFactory.Options options = new BitmapFactory.Options(); 
options. inSampleSize = 2; // 设 置 图 片 的 容量 大 小 为 原始 大 小 的 1/2 
Bitmap bitmap = BitmapFactory.decodeFile( u path, options ); 
u image. setImageBitmap(bitmap); 
u field.setVisibility( View.GONE ); 
) 


/* 生命 周期 方法 : 当 系统 要 销毁 activity 之 前 调用 * / 

@Override 

protected void onSaveInstanceState( Bundle outState ) { 
outState.putBoolean( AndCameraActivity.PHOTO TAKEN, u taken ); 

} 

/* 生命 周期 方法 : 如 果 activity 在 后 台 没有 因为 运行 内 存 吃 紧 被 清理 ， 
* 则 切换 回 时 会 触发 onRestoreInstanceState 方法 
*/ 

@Override 

protected void onRestoreInstanceState( Bundle savedInstanceState){ 
if( savedInstanceState. getBoolean( AndCameraActivity.PHOTO TAKEN ) ) ( 

onPhotoTaken( ) ; 
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85 

86 } 

O 第 29 行 设置 屏幕 的 方向 为 横向 的 。 因 模拟 器 一 般 是 纵向 显示 的 ,而 拍照 取景 一 般 是 
横向 的 ,所 以 在 setContentView(R. layout. main) ; 执行 之 前 要 设 定 屏幕 的 显示 方向 。 设 置 屏 
幕 为 横向 还 可 以 使 用 下 列 方式 ， 


this. setRequestedOrientation(ActivityInfo. SCREEN ORIENTATION LANDSCAPE) 


@ 第 37 行 设置 拍照 的 图 片 文件 保存 的 路 径 及 文件 名 。 这 里 指定 的 是 保存 在 SD 卡 中 。 

@ 第 45 行 是 创建 一 个 Intent, 这 个 Intent 是 Android 自 带 的 Camera 捕捉 图 像 应 用 程 
序 。 这 里 ,android. provider. MediaStore. ACTION IMAGE CAPTURE 表示 是 捕捉 图 像 ,如 
果 参 数 是 android. provider. MediaStore. ACTION_VIDEO_CAPTURE, 则 表示 是 捕捉 视频 。 
第 47 行 是 启动 Camera 程序 。 

@ 第 52 一 60 行 重 写 了 onActivityResultO 。 当 子 模块 事情 做 完 之 后 返回 主 界面 ,需要 接 
着 处 理由 子 模块 返回 的 数据 ,可 在 回调 方法 onActivityResult() 中 定义 实现 。 该 方法 的 参数 
requestCode 用 于 判断 是 从 哪个 Activity 返回 的 ,如 果 值 宇 0, 通 常 表示 从 用 户 定义 的 子 模块 中 
返回 ,如 果 值 = 一 1, 表 示 从 系统 的 子 模块 中 返回 。 在 本 例 中 , 当 requestCode — — 1 时 表示 从 
Camera 应 用 程序 中 返回 ,那么 在 返回 后 需要 调用 onPhotoTaken() 方 法 来 显示 由 Camera 捕 
获 的 图 片 。 

© 第 62 一 69 行 定义 onPhotoTaken() 方 法 ,显示 由 Camera 捕获 的 照片 。 第 65 行 是 确定 
图 片 显示 的 大 小 。 当 options. inSampleSize = 1 时 ,设置 图 片 的 容量 大 小 为 原始 大 小 ; 当 
options. inSampleSize = 2 时 ,设置 图 片 的 容量 大 小 为 原始 大 小 的 1/2。 从 main. xml 中 知道 ， 
图 片 控 件 u_image 与 文本 控件 u_field 是 在 同一 位 置 上 布局 的 ,因此 ,在 显示 图 片 时 ,文本 u_ 
field 必须 设置 为 不 可 见 , 且 不 占 布局 空间 ,所 以 在 第 68 行 调用 方法 : 


u_field. setVisibility( View.GONE ); 


© 第 73 一 75 行 重 写生 命 周 期 方法 onSaveInstanceState() ,此 方法 在 系统 要 销毁 Activity 
之 前 调用 ,用 于 保存 该 Activity 的 状态 。 

@ 第 80 一 84 行 重 写生 命 周期 方法 RestoreInstanceState O ,此 方法 在 Activity 被 销毁 后 
重新 启用 时 调用 ,用 于 恢复 该 Activity 的 状态 。 

(4) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml, 添 加 权限 ,其 代码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 


2 «manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
3 package = "cn. con. sgnsc. andcamera" 


4 android:versionCode - "1" 

5 android:versionName - "1.0" » 

6 

7 « uses - sdk android:minSdkVersion = "10" /> 

8 

9 « application 

10 android: icon = "(Qdrawable/ic launcher" 
11 android: label = "@string/app_name" > 

12 <activity 

13 android: label = "@ string/app_name" 


14 android:name = ".AndCameraActivity" > 
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15 < intent - filter > 

16 « action android:name = "android. intent. action. MAIN" /> 

17 

18 < category android:name = "android. intent. category. LAUNCHER" /> 
19 «/intent - filter > 

20 «/activity» 

21 «/application? 

22 

23 «uses- permission android:name = "android. permission. WRITE EXTERNAL STORAGE"/» 
24 


25 </manifest > 


第 23 行 添加 存储 卡 的 可 写 人 权限 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 AndCamera 项 目 。 初 始 运行 
时 可 以 看 到 一 个 横 置 的 界面 ,对 于 模拟 器 ,还 需要 按 下 Ctrl 十 F12 键 将 模拟 器 横 置 (第 1 章 中 
已 介绍 ) ,如 图 8-15 所 示 。 单 击 Take Photo 按钮 即 可 调用 系统 的 Camera 程序 ,如 图 8-16 所 
示 。 在 按 下 Camera 的 快门 键 之 后 进行 拍照 ,并且 可 以 即时 浏览 拍照 的 效果 ,如 图 8-17 所 示 。 
如 果 不 满意 可 以 单 击 RETAKE 按钮 重新 拍照 或 单 击 CANCEL 按钮 删除 照片 ,如 果 满 意 则 单 
击 OK 按钮 ,返回 主 界面 ,并 可 以 在 界面 上 显示 所 拍 的 照片 ,如 图 8-18 所 示 。 注 意 ,在 真 机 上 
运行 效果 更 好 。 


LR RAE 


Photo capture Example 


图 8-15 初始 运行 时 的 界面 Æ 8-16 调用 Camera 程序 界面 


Take Photo 


图 8-17 拍照 后 的 Camera 界面 图 8-18 返回 主 界面 显示 照片 


本 例 是 使 用 Camera 进行 拍照 ,也 可 以 使 用 Camera 进行 摄像 应 用 。 但 是 由 系统 自 带 的 
Camera 应 用 程序 的 界面 是 不 能 修改 的 , 且 按 钮 是 英文 显示 的 。 如 果 想 按照 用 户 自己 的 意图 来 
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设计 拍照 界面 ,就 需要 用 到 Camera 类 由 程序 员 编 程 设 计 。 
2. 使 用 Camera 类 


Android 的 Camera 类 位 于 android. hardware 包 下 ,Camera 类 包含 取景 器 (viewfinder) 和 
拍摄 照片 的 功能 。 使 用 Camera 类 开发 图 像 采 集 应 用 时 ,需要 在 布局 文件 中 添加 SurfaceView 
视图 ,作为 摄像 头 屏幕 ,在 代码 程序 中 要 实现 SurfaceHolder. Callback 接口 Camera 类 常用 
的 方法 如 表 8-10 所 示 。 


表 8-10 Camera 类 常用 的 方法 及 说 明 


方 法 描 述 
open() 使 用 静态 open() 方 法 访问 Camera 服务 
release() 应 用 程序 完成 服务 后 ,使 用 release() 释 放 连 接 
setParameters () 照相 机 参数 设置 
startPreview () 打开 照相 机 预览 功能 
stopPreview () 停止 照相 机 预览 
takePicture(Camera. ShutterCallback KAHR., Hp, 
shutter, Camera. 第 一 个 参数 为 快门 ,回调 方法 onShutter() 在 快门 关闭 后 立即 触发 ; 
PictureCallback raw, Camera. 第 二 个 参数 为 raw 数据 ,图 片 原始 数据 通过 byte ] 传 入 回调 方法 ; 
PictureCallback jpeg) 第 三 个 参数 为 jpeg 格式 的 数据 ,图 片 数据 通过 byte[ ] 传 人 回调 方法 


下 面 通过 案例 来 说 明 如 何 使 用 Camera 类 来 开发 自己 的 图 像 采集 应 用 。 

【案例 8. 11】 使 用 Camera 类 设计 一 个 简单 的 拍照 应 用 ,要 求 可 以 实现 拍照 . 重 拍 、 保 存 
和 预览 功能 ,拍照 文件 以 take. picture *** . jpg 命名 ,保存 在 SD 卡 的 CameraTest 下 。 

【说 明 】 使 用 Camera 类 需要 在 布局 中 添加 一 个 SurfaceView 视图 。 与 案例 8. 8 一样 ,用 
Camera 控制 取景 拍照 ,用 SurfaceView 显示 预览 。 

用 Java 开发 一 个 专门 用 于 图 片 处 理 的 类 ,负责 图 片 的 裁剪 、 缩 放 、 合 并 、 保 存 等 功能 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 PicCamera 的 Android 项 目 。 其 应 用 程序 名 
为 PictureCamera, 包 名 为 cn. com. sgmsc. PCamera, Activity 组 件 名 为 PicCameraActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,将 按钮 设置 在 屏幕 的 中 部 ,以 
此 作 分 隔 , 上 半 部 作为 取景 视窗 ,下 半 部 作为 浏览 视窗 。 代 码 如 下 所 示 。 

1 <?xml version = "1.0" encoding = "utf 一 8"?> 

2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 

3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:gravity- "center horizontal" 

7 ><! -- 添加 一 个 垂直 的 线性 布局 -一 > 
8 


< SurfaceView 


9 android:id= "@ + id/mySurfaceView" 
10 android:gravity= "center horizontal" 
11 android:layout width- "wrap content" 
12 android:layout height = "200px" 


13 /><! -- 添加 一 个 SurfaceView 用 于 浏览 --> 
14 < LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


15 
16 
£t 
18 
19 
20 
21 
22 
23 
24 
25 
26 
21 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:gravity- "center horizontal" 
><! -- 添加 一 个 线性 布局 -一 > 
< ImageButton 
android: id = "@ + id/camerabtn" 
android: textSize = "18px" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(d drawable/cameral" 
/><! -- 添 加 “打开 ?按钮 --> 
< ImageButton 
android: id= "(9 + id/savedbtn" 
android:textSize = "18px" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(9 drawable/savel" 
/><! -一 添加 “保存 "按钮 --> 
< ImageButton 
android: id = "(à + id/redobtn" 
android:textSize = "18px" 
android: layout_width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(d)drawable/redol" 
/><! -- RW AR RA -一 > 
</LinearLayout > 
< ImageView 
android: id= "(9 + id/myImageView" 
android:layout gravity = "center" 
android:layout width = "wrap content" 
android:layout height = "wrap content" /> 


46 «/LinearLayout > 


(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Pcamera fJ F ff PicCameraActivity. java 3C 


件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. con. sgnsc. PCanera; 


import java. io. IOException; 

import android. app. Activity; 

import android. graphics. Bitmap; 

import android. graphics. BitmapFactory; 

import android. graphics. PixelFormat; 

import android. hardware. Camera; 

import android. hardware. Camera. PictureCallback; 
import android. hardware. Camera. ShutterCallback; 
import android. os. Bundle; 

import android. os. Environment; 

import android. view. MotionEvent; 

import android. view. SurfaceHolder; 

import android. view.SurfaceView; 

import android. view. View; 

import android. view. Window; 

import android. view. WindowManager; 

import android. view. View. OnTouchListener; 
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20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 


61 


62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 


import android. widget. Button; 
import android. widget. ImageButton; 
import android. widget. Toast; 
import android. widget. ImageView; 


public class PicCameraActivity extends Activity implements SurfaceHolder. Callback { 


/** 当 Rctivity 首 次 创建 时 调用 */ 

private Bitmap[] bmps = new Bitmap[6]; 

private Camera myCamera; 

private ImageButton mButCamera, mButSaved, mButRedo; 
private ImageView myImageView; 


// 定 义 private 对 象 

private SurfaceView mSurfaceView; 

private SurfaceHolder myholder; 

private AutoFocusCallback mAutoFocusCallback = new AutoFocusCallback(); 
private String path = "CanmeraTest"; // 定 义 文件 夹 名 

private String name = "take picture"; ”// 定 义 照 片 文件 名 前 缀 

private Bitmap bmp = null; 

private int count; 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
/* 设置 窗口 全 屏 显 示 * / 
this. getWindow( ). setFlags(WindowManager. LayoutParams. FLAG_ FULLSCREEN, 
WindowManager.LayoutParams.FLAG FULLSCREEN); 
/* 隐藏 标题 栏 * / 
requestWindowFeature(Window.FEATURE NO TITLE); 
setContentView(R. layout. main); 


mSurfaceView = (SurfaceView) findViewById(R. id. nySurfaceView); 
myholder = mSurfaceView.getHolder(); 

myholder. addCallback(PicCameraActivity. this); 
myholder.setType(SurfaceHolder. SURFACE TYPE PUSH BUFFERS); 


myImageView = (ImageView) findViewById(R. id. myImageView); 


mButCamera = (ImageButton) findViewById(R. id. camerabtn); 
mButSaved = (ImageButton) findViewById(R. id. savedbtn) ; 

SRR ”按钮 (1、 保 存 文件 , 读 取 上 传 ) 
mButRedo = (ImageButton) findViewById(R. id. redobtn) ; 

/A* 重 拍 ”按钮 (放弃 保存 文件 ,并 重新 拍照 ) 


/* 按钮 效果 处 理 * / 
mButCamera. setOnTouchListener(new OnTouchListener() { 

//…… 省 略 一 ,省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
n; 


mButSaved. setOnTouchListener(new OnTouchListener() { 
//… 省 略 二 ,省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
DE 


mButRedo. setOnTouchListener(new OnTouchListener() ( 
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// -省略 三 ,省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
p; 


/* 拍照 按钮 的 事件 处 理 * / 

mButCamera. setOnClickListener(new Button. OnClickListener() ( 
//…… 省 略 四 ,省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 

DE 


/* 保存 按钮 的 事件 处 理 * / 

mButSaved. setOnClickListener(new Button. OnClickListener() { 
//…… 省 上 略 五 ,省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 

D; 


/* 重 拍 按钮 的 事件 处 理 * / 
mButRedo. setOnClickListener(new Button. OnClickListener() { 
//…… 省 略 六 ,省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
ni 
} 
//@Override 
public void surfaceCreated(SurfaceHolder surfaceholder) { 
try { 
/* 打开 相机 */ 
myCamera = myCamera. open(); 
myCamera. setPreviewDisplay(myholder); 
} catch (IOException exception) { 
myCanera. release( ) ; 
myCamera = null; 
) 
} 
//@Override 
public void surfaceChanged( SurfaceHolder surfaceholder, int format, int w, int h) { 
/* 相机 初始 化 * / 
initCamera(); 
count**; 
) 
//(&0verride 
public void surfaceDestroyed(SurfaceHolder surfaceholder) ( 
stopCamera(); 
myCamera. release(); 
myCamera = null; 


ShutterCallback myShutterCallback = new ShutterCallback()( 

//…" 省 略 七 ,省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
PictureCallback myRawCallback = new PictureCallback(){ 

//…~ 省 略 八 ,省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 
PictureCallback myjpegCallback = new PictureCallback()í 
//…- 省 略 九 ,省 略 了 该 方法 的 代码 段 , 相 应 代码 将 在 后 面 给 出 解析 


+ 


public final class AutoFocusCallback implements android. hardware. Camera. RutoFocusCallback { 
//… 省 略 十 ,省 略 了 该 内 部 类 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
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128 private void takePicture() { 


129 //~…… 省 略 十 一 ,省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
130 E 

131 private ShutterCallback shutterCallback = new ShutterCallback() { 
132 public void onShutter() { 

133 /* 按 下 快门 瞬间 会 调用 这 里 的 程序 */ 

134 } 

13 ë} 

136 private PictureCallback rawCallback = new PictureCallback() { 

137 public void onPictureTaken(byte[] data, Camera camera) { 

138 

139 ) 

140  }; 

141 private PictureCallback jpegCallback = new PictureCallback() ( 

142 //……" 省 略 十 二 ,省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
13  h 

144 


145  /x 相机 初始 化 的 方法 * / 
146 private void initCamera() { 


147 if (myCamera != null) { 

148 try ( 

149 Camera.Parameters parameters = myCamera.getParameters(); 
150 parameters. setPictureFormat(PixelFormat. JPEG) ; 
151 parameters.setPictureSize(1024, 768); 

152 name - "take picture"; 

153 

154 parameters, setPreviewSize(200, 200);//BE WE K/h 
155 myCanera. setParameters(parameters); 

156 myCanera. setPreviewDisplay(myholder); 

157 myCamera. startPreview(); 

158 ) catch (Exception e) ( 

159 e. printStackTrace() ; 

160 } 

161 } 

162 } 

163 


164  /* 停止 相机 的 方法 */ 
165 private void stopCamera() { 


166 if (myCamera !- null) ( 

167 try{ 

168 /* 停止 预览 */ 

169 myCanera. stopPreview(); 
170 ) catch (Exception e) { 

171 e. printStackTrace(); 
172 } 

173 } 

174 } 

175 } 


CD 58 46,47 行 设置 窗口 全 屏 显 示 。 在 Android 中 设置 窗口 的 显示 属性 可 使 用 方法 
getWindowO. setFlags()。 如 本 行 语 句 是 设置 窗口 全 屏 : 


getWindow().setFlags(WindowManager.LayoutParams.FLAG FULLSCREEN, 
WindowManager. LayoutParams.FLAG FULLSCREEN); 


设置 窗口 始终 点 亮 : 
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EgetWindow().setFlags(WindowManager.LayoutParams.FLAG KEEP SCREEN ON, 
WindowManager.LayoutParams.FLAG KEEP SCREEN ON); 


设置 窗口 背景 模糊 : 


getWindow().setFlags(WindowManager.LayoutParams.FLAG BLUR BEHIND, 
WindowManager.LayoutParams.FLAG BLUR BEHIND); 

© $ 52 — 55 fT. TE Activity 的 OnCreate 函数 中 设置 好 SurfaceView, 包括 设置 
SurfaceHolder. Callback Xf 4 fll SurfaceHolder 对 象 的 类 型 。 

© 58 92—101 fT. 8&5 SurfaceHolder. Callback 的 surfaceCreated() 方 法 。 第 95 行使 用 
Camera 的 open() 方 法 开启 摄像 头 硬件 ,这 个 API 在 SDK 2. 3 之 前 是 没有 参数 的 ,2. 3 以 后 支 
持 多 摄像 头 , 所 以 开启 前 可 以 通过 getNumberOfCameras() 方 法 先 获取 摄像 头 数 目 , 再 通过 
getCameraInfo( ) 方 法 得 到 需要 开启 的 摄像 头 ID ,然后 传人 open 函数 开启 摄像 头 ,假如 摄像 头 
开启 成 功 则 返回 一 个 Camera 对 象 ,否则 就 扫 出 异常 。 第 96 行 ,setPreviewDisplay 为 摄像 头 
设置 SurfaceHolder 对 象 。 

®© 第 103 一 107 行 , 重 写 SurfaceHolder. Callback 的 surfaceChanged() 方 法 。 在 该 方法 中 
初始 化 Camera, 其 具体 操作 在 方法 initCamera() 中 定义 。 

© 第 146—162 行 定义 了 initCamera() 方 法 。 在 该 方法 中 设置 了 Camera 摄取 的 图 片 的 
文件 格式 、 图 片 大 小 ,文件 名 ,以 及 预览 的 屏幕 大 小 等 属性 。 第 157 行 startPreview() 开 始 
预览 。 

© $ 165—174 行 定义 了 stopCamera() 方 法 。 在 该 方法 中 停止 相机 的 预览 功能 。 

接 下 来 对 省 略 的 部 分 代码 作 解 析 。 

省 略 一 ,省 略 二 ,省 略 三 ; 这 部 分 省 略 的 代码 是 定义 三 个 按钮 被 按 下 或 抬 起 的 效果 , 当 按 
下 按钮 时 按钮 图 片 呈 按 下 图 标 ,释放 按钮 时 按钮 图 片 呈 常态 图 标 。 具 体 代 码 如 下 。 

1 /x 按钮 效果 处 理 * / 


2 mButCamera. setOnTouchListener(new OnTouchListener() { 


3 

4 //@Override 

5 public boolean onTouch(View v, MotionEvent event) { 

6 if (event. getAction() == MotionEvent.ACTION DOWN) { 

7 // 更 改 为 按 下 时 的 背景 图 片 

8 bmps[0] = BitmapFactory. decodeResource(getResources(), 

9 R. drawable. camera2) ; 
10 mButCanera. setImageBitmap(bmps[0]); 

11 } else if (event.getAction() == MotionEvent. ACTION UP) { 

12 // 改 为 抬 起 时 的 图 片 

13 bmps[1] = BitmapFactory.decodeResource(getResources(), 

14 R. drawable. cameral); 
15 mButCamera. setImageBitmap(bmps[1]); 

16 } 

17 return false; 

18 } 

19 }); 

20 


21 mButSaved. setOnTouchListener(new OnTouchListener() { 

22 //…… 此 处 代码 与 nButCanera. setOnTouchListener() 中 的 代码 定义 相似 ,在 此 省 略 
23 p; 

24 
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25 nButRedo. setOnTouchListener(new OnTouchListener() { 
//…… 此 处 代码 与 nButCamera. setOnTouchListener() 中 的 代码 定义 相似 ,在 此 省 略 


26 


27 i 


(D 第 2 一 19 行 是 定义 拍照 按钮 mButCamera 的 按钮 效果 , 当 按 下 按钮 时 按钮 图 片 呈 
bmpsL0] 中 的 图 标 , 当 释 放 按钮 时 按钮 图 片 呈 bmps[1] 中 的 图 标 。 

@ 其 余 的 按钮 效果 定义 与 mButCamera 的 按钮 效果 相似 , 当 按 下 mButSaved 按钮 时 图 片 
Æ bmps[2] 中 的 图 标 , 当 释 放 该 按钮 时 按钮 图 片 呈 bmps[3] 中 的 图 标 ; 当 按 下 mButRedo f£ 
钮 时 图 片 呈 bmps[L4] 中 的 图 标 , 当 释放 该 按钮 时 按钮 图 片 呈 bmps[5] 中 的 图 标 。 具 体 代 码 在 


此 省 略 。 

省 略 四 、 省 略 十 省略 十 一 、 省 略 十 二 : 这 部 分 省 略 的 代码 是 定义 拍照 事件 的 处 理 。 具 体 
代码 如 下 。 

1 /* 拍照 按钮 的 事件 处 理 x / 

2 mButCamera. setOnClickListener(new Button. OnClickListener() { 

3 //@Override 

4 public void onClick(View arg0) { 

5 /* 设置 按钮 可 见 性 并 拍照 * / 

6 mButCamera. setVisibility(View. GONE); 

7 mButRedo. setVisibility(View.GONE); 

8 if (bmps[0] != null && !bmps[0]. isRecycled()) 

9 bnps[0]. recycle(); 

10 /* 对 焦 拍照 * / 

11 myCamera.autoFocus(mAutoFocusCallback); ”// 调 用 AutoFocusCallback 类 

12 myImageView. setImageBitmap(null); 

13 } 

14 H; 

15 

16 // — NERA IR 

17 

18 public final class AutoFocusCallback implements android. hardware. Camera. AutoFocusCallback { 

19 public void onAutoFocus(boolean focused, Camera camera) { 

20 /* 对 到 焦点 拍照 */ 

21 if (focused) ( 

22 takePicture(); 

23 ) else 

24 mButCamera. setVisibility(View. VISIBLE) ; 

25 } 

26 } 

27 private void takePicture() { 

28 if (myCamera != null) { 

29 myCamera. takePicture( shutterCallback, rawCallback, jpegCallback); 

30 } 

31 } 

32 private ShutterCallback shutterCallback = new ShutterCallback() { 

33 public void onShutter() ( 

34 /* 按 下 快门 瞬间 会 调用 这 里 的 程序 * / 

35 ) 

36 Im 

3 private PictureCallback rawCallback = new PictureCallback() { 

38 public void onPictureTaken(byte[] data, Camera camera) ( 

39 


) 
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41 l; 

42 private PictureCallback jpegCallback = new PictureCallback() { 
43 public void onPictureTaken(byte[] data, Camera camera) { 
44 /* 取得 相片 * / 

45 try { 

46 /* 设 定 Button 可 视 性 */ 

47 mButCamera. setVisibility(View. GONE) ; 

48 mButSaved. setVisibility(View. VISIBLE) ; 

49 mButRedo. setVisibility(View. VISIBLE) ; 

50 /* 取得 相片 Bitmap 对 象 * / 

51 bmp = BitmapFactory.decodeByteArray( data, 0, data.length); 
52 ) catch (Exception e) ( 

53 e. printStackTrace() ; 

54 ) 

55 ) 

56 h 


D 55 2—14 TE X. TESI mButCamera 的 OnClickListener 监听 器 ,在 其 onClick O77 iE 
设置 按钮 的 可 见 性 ,第 8,9 行 设置 释放 “拍照 ”按钮 ,这 里 的 语句 作用 是 : 如 果 Bitmap 数组 元 
素 bmps[0] 没 有 被 系统 回收 就 执行 回收 ,为 内 存 提 供 空间 。 第 11 行 设置 自动 对 焦 拍 照 。 第 
12 行 设 置 ImageView 控件 为 初始 状态 。 

© 第 11 行将 通过 对 象 mAutoFocusCallback 调用 AutoFocusCallback 类 中 定义 的 代码 。 

© 58 18—26 行 定 义 AutoFocusCallback 类 。 其 中 第 21,22 行 代码 是 定义 对 焦 后 即刻 调 
用 takePicture() 方 法 。 

@ 58 27 一 31 行 定 义 takePicture() 方 法 。 只 要 myCamera 对 象 存 在 即 调用 myCamera 的 
实现 拍照 方法 takePicture(shutterCallback，rawCallback，jpegCallback) 。 在 快门 关闭 后 立 
即 触发 回调 方法 onShutter() ,该 方法 定义 在 第 32 一 36 行 ; 图 片 原始 数据 通过 byte[] 传 人 回 
调 方法 ,该 方法 定义 在 第 37 一 41 行 ; 图 片 为 jpeg 格式 的 数据 ,图 片 数据 通过 byte[ ] 传 人 回调 
方法 ,该 方法 定义 在 第 42 一 56 行 ,其 中 第 51 行将 拍 得 的 照片 传人 Bitmap 对 象 bmp 中 。 

省 略 五 省略 六 省略 七 .省略 八 .省略 九 : 这 部 分 省 略 的 代码 是 定义 保存 和 重 拍 事件 的 处 
理 。 具 体 代 码 如 下 。 


1 /*“ 保 存 " 按 钮 的 事件 处 理 * / 

2 mButSaved. setOnClickListener(new Button. OnClickListener() { 

3 //@Override 

4 public void onClick(View arg0) ( 

5 mButSaved. setVisibility(View. GONE); 

6 mButRedo. setVisibility(View. GONE); 

7 /* 保存 文件 * / 

8 if (bmp != null) { 

9 /* 检查 SD Card 是 否 存在 */ 

10 if (!Environment.MEDIA MOUNTED. equals(Environment. getExternalStorage State())) ( 
11 /* SD 卡 不 存在 ,显示 Toast 信息 * / 

12 Toast. makeText(PicCameraActivity. this, "SD 卡 不 存在 ! 上 传 失败 !"， 

13 Toast.LENGTH LONG). show() ; 

14 ) eise( 

15 try { 

16 ImageTool. saveImage(bmp, path, name, 100) ; 

17 myCamera. takePicture(myShutterCallback, myRawCallback, myjpegCallback); 
18 Toast. makeText(PicCameraActivity. this, "相片 保存 成 功 !"， 


19 Toast.LENGTH LONG). show() ; 
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20 } catch (Exception e) ( 

2t e. printStackTrace() ; 

22 } 

23 } 

24 } 

25 if (!bmp. isRecycled()) 

26 bmp. recycle(); 

27 mButCamera. setVisibility(View. VISIBLE); 

28 /* 重新 设 定 Camera * / 

29 stopCamera(); 

30 initCamera(); 

31 $ 

32 »; 

33 

34 /*“ 重 拍 ” 按 钮 的 事件 处 理 * / 

35 mButRedo. setOnClickListener(new Button. OnClickListener() { 
36 //@Override 

37 public void onClick(View arg0) { 

38 mButCamera. setVisibility(View. VISIBLE) ; 

39 mButSaved. setVisibility(View. GONE); 

40 mButRedo. setVisibility(View.GONE); 

41 /* 重新 设 定 Camera * / 

42 if (!bmp. isRecycled()) 

43 bnp. recycle(); 

44 stopCamera(); 

45 initCamera(); 

46 } 

47 DE 

48 

49. //…… 省 略 部 分 代码 

50 

51 ShutterCallback myShutterCallback = new ShutterCallback(){ 
52 (QOverride 

53 public void onShutter()() 

54 }; 

55 PictureCallback myRawCallback = new PictureCallback()( 

56 (GOverride 

57 public void onPictureTaken(byte[] data, Camera camera) {} 
58 ); 

59 PictureCallback myjpegCallback = new PictureCallback()( 

60 @Override 

61 public void onPictureTaken(byte[] data, Camera camera) { 
62 Bitmap bm = BitmapFactory.decodeByteArray(data, 0, data. length); 
63 nyInageView. setImageBitmap(bm); // 将 图 片 显示 到 下 方 的 ImageView 中 
64 ) 

65 h 


D 5$ 2—32 frg X. T "ite" fll OnClickListener 监听 。 在 onClick() 方 法 中 设置 按钮 
的 可 见 状态 ; 判断 SD 卡 是 否 存在 ,如 果 存 在 则 调用 ImageTool 类 的 saveImage() 方 法 将 bmp 
中 的 图 片 保存 到 指定 的 SD 卡 的 路 径 中 ,并 再 次 调用 takePicture() 方 法 ; 然后 回收 bmp 对 象 ， 
设置 “拍照 ”按钮 可 见 , 重 新 设 定 Camera, 

@ 第 17 行 是 青 次 调用 takePicture() 方 法 的 语句 。 该 语句 的 作用 是 当 拍 照 完 成 后 即刻 调 
用 myShutterCallback 对 象 的 回调 方法 ,该 方法 定义 在 第 51 一 54 £1; 得 到 图 片 后 ; 图 片 原始 
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数据 通过 byte[] 传 人 回调 方法 ,该 方法 定义 在 第 55 一 58 fF; 图 片 为 jpeg 格式 的 数据 ,图 片 数 
据 通过 byte 传人 回调 方法 ,该 方法 定义 在 第 59 一 65 行 ,主要 执行 将 拍照 所 得 图 片 显示 在 下 
方 的 ImageView 控件 中 。 

© 第 35~47 行 定义 了 “ 重 拍 ” 按 钮 OnClickListener 监听 。 在 onClickQ) 方 法 中 设置 按钮 
的 可 见 状态 ,回收 bmp 对 象 ,重新 设 定 Camera. 

(4) 开发 ImageTool 类 代码 。 在 src/cn. com. sgmsc. Pcamera 包 下 创建 ImageTool. java 
文件 并 编辑 之 。 这 个 自 定义 类 包括 对 图 片 的 常用 操作 处 理 方法 ,有 一 定 实用 价值 。 在 此 只 对 
本 例 将 用 到 的 saveImage() 方 法 作 解析 ,省 略 了 其 余部 分 代码 ,完整 代码 可 参见 本 书 下 载 资 源 
指定 网 址 上 的 源 代码 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. PCamera; 


import java. io. File; 

import java. io.FileOutputStream; 
import java. util. Calendar; 
import java. util. Date; 

import android. graphics. Bitmap; 
import android. graphics. Matrix; 
import android. os. Environment; 
import android. util. Log; 


public class ImageTool ( 


// 切 割 图 片 的 一 部 分 

public static Bitmap imageCut(Bitmap bmp, int left, int top, int right, int bottom) ( 
//…… 省 略 了 该 方法 的 代码 段 ,参见 本 书 源 代码 

} 


// 把 图 片 按 固 定 比 例 缩小 

public static Bitmap imageZoom(Bitmap bmp, int iWidth, int iHeight) { 
//…" 省 略 了 该 方法 的 代码 段 ,参见 本 书 源 代码 

} 


// 图 片 合并 

public static Bitmap imageMerge(Bitmap[] bmps) ( 
//…… 省 略 了 该 方法 的 代码 段 ,参见 本 书 源 代码 

} 


// 保 存 图 片 
public static void saveImage(Bitmap bmp, String path, String filename, int quality) { 
String time = callTime(); 
if (bmp != null) ( 
try ( 
/* 文件 夹 不 存在 就 创建 * / 
Filef = new File(Environment. getExternalStorageDirectory(), path); 
if (!f.exists()) ( 
f.nkdir(); 
) 
/* 保存 相片 文件 * / 
Filen = null; 
n 7 newFile(f, filename * time * ".jpg"); 
FileOutputStream bos = new FileOutputStream(n.getAbsolutePath()); 
/x 文件 转换 * / 
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43 bmp. compress(Bitmap.CompressFormat.JPEG, quality, bos); 
44 / * 调用 flush() 方 法 ,更 新 BufferStream * / 
45 bos. flush(); 

46 /* 结束 OutputStream * / 

47 bos.close(); 

48 ) catch (Exception e) ( 

49 e. printStackTrace() ; 

50 } 

51 } 

52 if(! bmp. isRecycled()) 

53 bmp. recycle(); 

54 } 

55 

56 // 获 取 系统 时 间 

57 public static String callTime() { 

58 //…… 省 略 了 该 方法 的 代码 段 ,参见 本 书 源 代码 

59 } 

60 ] 


(D 第 34—37 行 定义 从 指定 的 路 径 中 获取 文件 夹 ,判断 该 文件 夹 是 否 存在 ,如 果 不 存在 则 
建立 。 

© 58 39.40 行 定义 在 指定 的 文件 夹 中 创建 一 个 以 filename + time 十 ". jpg" 命 名 的 文 
件 。 其 中 参数 filename 从 PicCameraActivity 类 中 得 到 ,其 值 为 “filename”, 由 此 构成 的 文件 
名 为 take picture ** .jpg ,符合 案例 的 要 求 。 

© 第 41 一 47 行 定 义 了 从 bmp 中 将 照片 转换 入 take. picture *x*x .jpg 文件 中 。 

@ 第 52.53 行 是 回收 bmp 对象 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 PicCamera 项 目 。 初 始 运行 时 
界面 如 图 8-19 所 示 。 单 击 “ 拍 照 ”按钮 ,照片 在 按钮 上 方 显示 ,可 见 “ 保 存 ”" 和 “ 重 拍 ” 按 钮 ,如 
图 8-20 所 示 。 单 击 “ 保 存 ” 按 钮 ,照片 在 按钮 下 方 显示 ,如 果 保 存 成 功 则 提示 “相片 保存 成 
功 !”, 如 图 8-21 所 示 。 


相片 保存 成 功 ! 


图 8-19 初始 运行 界面 图 8-20 单 击 “ 拍 照 "按钮 后 图 8-21 单 击 “ 保 存 ” 按 钮 后 
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本 章 对 运行 于 Android 平台 上 的 相关 多 媒体 技术 作 了 集中 介绍 。 主 要 以 案例 的 形式 说 明 
关于 二 维 ,三 维 图 形 应 用 ,动画 应 用 ,音频 、 视 频 的 播放 应 用 ,录制 声音 和 拍摄 图 像 等 应 用 的 编 
程 实现 方法 。 由 于 Android 的 版 本 升级 较 快 ,对 多 媒体 技术 的 支持 度 也 随 着 版 本 的 升级 而 更 
新 ,所 以 ,在 实践 中 ,读者 还 需 不 断 学 习 , 不 断 地 丰富 对 多 媒体 应 用 的 编程 技巧 ,掌握 其 更 精湛 
的 技术 。 

在 第 8. 3 节 中 ,介绍 了 音频 文件 的 播放 应 用 。 在 Android 中 对 音频 的 播放 和 管理 一 般 都 
与 Service 有 关 , 涉 及 后 台 的 处 理 操作 控制 问题 ,这 是 第 9 章 中 将 介绍 的 内 容 , 请 继续 学 习 。 


练习 


设计 微 博 的 拍照 功能 ,并 以 一 定 的 规律 为 照片 文件 命名 ,保存 到 SD 卡 中 。 
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在 Android 的 应 用 中 ,有 一 些 应 用 是 没有 界面 的 ,并 且 可 以 在 运行 其 他 应 用 时 同时 运行 这 
些 不 需要 界面 的 应 用 。 例 如 ,播放 音乐 ,接收 发 送 和 广播 消息 ,线程 内 的 数据 控制 等 。 这 些 都 
是 在 Android 后 台中 运行 着 的 代码 ,不 需要 在 屏幕 显示 中 作 布 局 设计 。 


6.1 消息 提示 


Android 系统 提供 一 套 友 好 的 消息 提示 机 制 , 不 会 打 断 用 户 当 前 的 操作 。 常 用 的 方式 有 
Toast 和 Notification。 下 面 分 别 介绍 这 两 种 消息 提示 的 用 法 。 


9.1.1 Toast 


Toast 类 在 android. widget 包 下 。 它 向 用 户 提 供 一 种 快速 的 即时 消息 ,消息 内 容 简短 。 
当 Toast 被 显示 时 ,悬浮 于 应 用 程序 的 最 上 方 , 没 有 焦点 ,停留 几 秒 钟 后 便 会 自动 消失 。Toast 
在 程序 中 常用 于 某 项 操作 执行 后 是 否 成 功 的 消息 提示 。 

Toast 对 象 的 创建 通过 makeText() 方 法 实现 。makeText() 方 法 有 两 种 格式 ,格式 一 : 
makeText(Context context. int resld. int duration) ,格式 二 : makeText (Context context. 
String message. int duration), rp ,第 一 个 参数 是 Toast 对 象 当 前 的 上 下 文 引用 ; 第 二 个 参 
数 在 格式 一 中 是 一 个 字符 串 的 资源 标识 符 ,在 格式 二 中 是 一 个 字符 串 ,其 字符 串 的 内 容 是 将 要 
显示 的 消息 内 容 ; 第 三 个 参数 是 指定 Toast 显示 的 时 间 长 度 ,通常 使 用 Toast 的 常量 
LENGTH_LONG( 值 为 1, 显 示 时 间 较 长 ), 或 者 LENGTH_SHORT( 值 为 0, 显示 时 间 较 短 ) 
来 表示 。 在 完成 Toast 对 象 创建 后 通过 show() 方 法 即 可 将 消息 提示 显示 在 屏幕 上 。 

Toast 的 默认 显示 方式 是 在 屏幕 的 下 半 部 位 置 , 且 只 有 文本 消息 。 可 以 使 用 Toast 的 一 
些 方法 改变 其 显示 效果 ,例如 ,将 Toast 显示 位 置 设置 到 屏幕 中 部 ,可 使 用 如 下 代码 。 

Toast toast = Toast.makeText(getApplicationContext()," 自 定义 位 置 Toast", Toast. LENGTH_LONG) ; 

toast. setGravity(Gravity.CENTER, 0, 0); 

toast. show( ); 

【案例 9.1】 完善 第 7 章 案例 7. 2 的 功能 。 在 系统 完成 对 数据 库 表 操 作 后 给 出 提示 消 
息 , 反 馈 操作 完成 的 情况 。 

【说 明 】 本 例 只 对 删除 日 志 给 出 Toast 消息 提示 ,其 余部 分 留 作 练 习 。 

【开发 步骤 及 解析 】 

CD 复制 已 有 项 目 。 复制 项 目 ZSWB_Diary2 为 ZSWB Diary3: 在 Eclipse 的 Project 
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Explorer 中 ,选择 项 目 ZSWB_Diary2 ,然后 选择 菜单 Edit>Copy, 再 选择 菜单 Edit Paste. 1T 
F Copy Project 对 话 框 ,在 Project name: 编辑 框 内 输入 *ZSWB_Diary3”, 如 图 9-1 所 示 。 单 
击 OK 按钮 即 可 完成 项 目的 复制 操作 。 

(2) 修改 代码 。 展 开 ZSWB_Diary3 项 目 , 修 改 src/cn. com. sgmsc. ZSWB 包 下 的 代码 文件 
DiaryListActivity. java。 增 加 的 代码 或 与 原 代 码 不 同 处 使 用 粗 体 显示 ,代码 如 下 所 示 。 


1 package cn. com. sgnsc. ZSWB; 

2 

3 import android. widget. Toast; 

4 //…… 省 略 部 分 引入 相关 类 的 代码 

5 

6 public class DiaryListActivity extends Activity { 

7 //…… 省 略 部 分 代码 

8 

9 RR: 删除 指定 的 日 志 记 录 

10 public void deleteDiary(int id)( //id 为 要 删除 记录 的 id 
11 SQLiteDatabase db = myHelper.getWritableDatabase();  // 获 得 数据 库 对 象 

12 try{ 

13 int count = db.delete(TABLE NAME, ID+"=?", new String[ ]{id+""}); 

14 db. close(); 

15 if(count == 1){ // 删 除 成 功 

16 Tbast . makeText (DiaryListActivity.this, "删除 日 志 成 功 !"，Tbast .LENGTH_LONG). show( ); 
17 getBasicInfo(myHelper); // 重 新 获取 数据 库 信 息 
18 myAdapter. notifyDataSetChanged(); // 刷 新 ListView 

19 } 

20 else{ // 删 除 失 败 

21 Toast. makeText (DiaryListActivity.this, "删除 失败 ,请 重 试 !"，Tbast.LENGTH LONG). show( ); 
22 ) 

23 ]catch(Exception e){ 

24 e. printStackTrace(); 

25 ) 

26 } 

27 } 


【运行 结果 】 运行 KDWB_Diary3 项 目 。 首 先 选择 一 条 日 志 , 按 下 手机 (或 模拟 器 ) 中 的 
menu 键 , 调 出 选项 菜单 , 单 击 * 删 除 ? 莱 单项 执行 删除 操作 , 当 对 数据 库 表 的 操作 完成 后 ,会 显 
示 提 示 消 息 ,如 图 9-2 所 示 。 


Project name: ZSWB_Diary3| 


IV] Use default location. 


android training workspace. | | Browse- 


图 9-1 “复制 项 目 ” 对 话 框 9-2 ”执行 删除 操作 之 后 的 Toast 提示 消息 


9.1.2 Notification 


Notification 类 在 android. app 包 下 。 它 是 另 一 种 提示 消息 的 方式 , Notification 无 须 
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Activity, 将 消息 内 容 显示 在 手机 状态 条 中 。 手 机 的 状态 条 位 于 屏幕 的 最 上 方 , 通 常 显示 电池 
电量 、 信 息 强度 等 信息 。 在 Android 手机 中 ,用 手指 按 住 状态 
条 往 下 拉 , 即 可 打开 状态 条 查看 系统 的 提示 消息 ,如 图 9-3 
所 示 。 

在 Android 中 ,Notification 包含 如 下 功能 : 创建 新 的 状 
态 栏 图 标 ,在 扩展 的 状态 条 窗口 显示 额外 的 信息 (也 可 以 发 起 
一 个 Intent) ,闪烁 /LED, 让 手机 振动 ,发 出 声音 (铃声 .媒体 库 歌 曲 ) 等 。 

所 有 的 Notification 对 象 由 NotificationManager 来 管理 ,NotificationManager 类 也 位 于 
android. app 包 下 。NotificationManager( 通 知 管理 器 ) 是 用 来 处 理 Notification 的 系统 服务 ， 
使 用 getSystemService() 方 法 可 以 获得 对 它 的 引用 。 通 过 使 用 NotificationManager, 可 以 触 
发 新 的 Notification ,修改 现 有 的 Notification 或 者 删除 那些 不 再 需要 的 Notification。 
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9-3 ”打开 的 状态 条 显示 


1. NotificationManager 和 Notification 中 的 常用 方法 和 属性 


NotificationManager 类 主要 负责 将 Notification 在 状态 条 显示 出 来 和 取消 ,常用 的 方法 
如 表 9-1 所 示 。 


表 9-1 NotificationManager 中 常用 的 方法 及 说 明 


5 法 描 x 
cancel(int id) 取消 以 前 显示 的 一 个 Notification, 如 果 是 一 个 短暂 的 
Notification, 试 图 将 其 隐藏 ,如 果 是 一 个 持久 的 Notification， 
将 从 状态 条 中 移 走 
cancelAll() 取消 以 前 显示 的 一 个 所 有 Notification 
getSystemService(NOTIFICATION_SERVICE) ”初始 化 一 个 NotificationManager 对 象 
notify(int id, Notification notification) 把 Notification 持久 地 发 送 到 状态 条 上 


Notification 类 常用 的 方法 如 表 9-2 所 示 。 
表 9-2 Notification 中 常用 的 方法 及 说 明 


方 法 描 述 
NotificationO 创建 一 个 默认 属性 的 Notification XE 
Notification(int icon, CharSequence tickerText, 创建 指定 图 标 、 显 示 文 本 内 容 、 显 示 时 间 的 一 个 
long when) Notification 对 象 。 一 般 是 立即 显示 ,第 三 个 参数 取 


System. currentTimeMillis() 
setLatestEventInfo (Context context, CharSequence 设置 显示 在 拉 伸 状态 栏 中 的 Notification 对 象 的 属性 ， 
contentTitle, CharSequence contentText ，PendingIntent 单 击 后 将 发 送 PendingIntent 对 象 。 其 中 ,第 一 个 参数 
contentIntent) 为 上 下 文 ; 第 二 个 参数 为 Notification 对 象 的 标题 ; 第 
三 个 参数 为 Notification 对 象 的 内 容 ; 第 四 个 参数 为 
PendingIntent 对 象 , 单 击 后 将 发 送 所 包含 的 intent 


问 一 下 

什么 是 PendingIntent? 它 与 Intent 有 什么 不 同 ? 

PendingIntent 类 是 一 个 Intent 的 描述 , 它 位 于 android. app 包 下 。Pending 一 词 的 含义 
是 即将 发 生 或 来 临 的 事情 。PendingIntent 这 个 类 用 于 处 理 即将 发 生 的 事情 。 例 如 在 通知 
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Notification 中 用 于 跳 转 页 面 ,但 不 是 马上 跳 转 。 

Intent 是 即时 启动 , 随 所 在 的 Activity 消失 而 消失 。 而 PendingIntent 可 以 看 作 是 对 
Intent 的 包装 ,通常 通过 getActivity() ,getBroadcast()、getService() 来 得 到 PendingIntent 的 
实例 ,当前 Activity 并 不 能 马上 启动 它 所 包含 的 Intent, 而 是 在 外 部 执行 PendingIntent 时 , 调 
用 Intent 的 。Intent 一 般 是 用 作 Activity、Sercvice、BroadcastReceiver 之 间 传 递 数 据 ,而 
PendingIntent 一 般 用 在 Notification 上 ,或 其 他 的 方法 参数 中 。 

Notification 里 面 有 很 多 属性 ,设置 这 个 类 主要 是 设置 Notification 的 相关 属性 。 下 面 是 
Notification 使 用 的 常用 属性 。 

defaults: 状态 条 的 默认 属性 。 

icon: 状态 条 的 图 标 。 

sound: 来 通知 时 的 提示 音 。 

tickerText: 显示 在 状态 条 中 的 提示 文本 。 

vibrate: 来 通知 时 振动 。 

when; 来 通知 时 的 时 间 。 

在 设置 属性 值 时 ,Notification 经 常 使 用 系统 定义 的 一 些 常量 ,如 : DEFAULT. ALL. fir 
用 所 有 属性 的 默认 值 ; DEFAULT LIGHTS, ,使 用 默认 闪烁 提示 ; DEFAULT. SOUND. ,使 用 
默认 提示 声音 ; DEFAULT_VIBRATE, 使 用 手机 振动 ; 等 等 。 注 意 ,模拟 器 不 支持 振动 ,在 
程序 测试 时 应 该 在 手机 设备 中 测试 带 振动 的 这 部 分 功能 。 


2. 使 用 Notification 和 NotificationManager 的 基本 步骤 


Notification 和 NotificationManager 操作 相对 比较 简单 ,一般 是 先 获取 一 个 NotificationManager 
对 象 , 然 后 实例 化 Notification ,设置 它 的 属性 ,最 后 通过 NotificationManager 对 象 发 出 通知 就 
可 以 了 。 具 体 的 步 又 如 下 。 

(1) 获取 NotificationManager 对 象 。 


String ns = Context.NOTIFICATION SERVICE; 
NotificationManager mNotificationManager = (NotificationManager) getSystemService(ns); 


(2) 创建 一 个 Notification 对 象 。 


Notification notification = new Notification(); 
notification. icon = R.drawable.notification icon; 


或 者 ,使 用 稍微 复杂 一 些 的 方法 创建 Notification 对 象 。 


int icon = R.drawable.notification icon; / 8 8 E bs 
CharSequence tickerText - "Hello"; / AR dS E (Status Bar) 显 示 的 通知 文本 提示 
long when = System.currentTineMillis(); // 通 知 产生 的 时 间 , 会 在 通知 信息 里 显示 


Notification notification = new Notification(icon, tickerText, when); 


(3) 设置 Notification 的 各 个 属性 ,如 内 容 、 图 标 、 标 题 、 相 应 的 动作 处 理 等 。 
O 设置 在 状态 条 (Status Bar) 中 显示 的 通知 文本 提示 ,如 : 


ONG 


notification.tickerText - "hello"; 
@ 设置 发 出 提示 音 ,如 : 


1 notification. defaults | = Notification. DEFAULT SOUND; 
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2 notification.sound = Uri.parse("file:///sdcard/notification/ringer. mp3"); 

3 notification. sound = Uri.withAppendedPath(Audio. Media. INTERNAL CONTENT URI, "6"); 

第 1 行 ,为 通知 对 象 notification RIME RERE AR. KA S ORA RT VUE « Pr DL 
用 “|=" 符 号 表示 会 加 新 的 显示 效果 。 如 果 notification 的 defaults 字段 包括 DEFAULT. SOUND 
属性 , 则 这 个 属性 将 覆盖 sound 字段 中 定义 的 声音 。 

@ 设置 手机 振动 ,如 : 

1 notification. defaults | = Notification. DEFAULT VIBRATE; 

2 long[] vibrate = (0,100,200,300); 

3 notification. vibrate = vibrate; 

名 第 1 行 ,为 通知 对 象 notification 添加 振动 效果 。 

名 第 3 行 ,设置 0ms 后 开始 振动 ,振动 100ms 后 停止 ,再 过 200ms 后 再 次 振动 300ms ,该 

设置 数据 由 第 2 行 的 数组 提供 。 
QD 设置 LED 灯 闪 烁 ,如 ， 


notification.defaults | = Notification. DEFAULT LIGHTS; 


或 者 ,设置 自己 的 LED 提醒 模式 : 


1 notification.ledARGB = Oxff00ff00; 

2 notification. ledOnMS = 300; // 亮 的 时 间 
3 notification. ledOffMS = 1000; // 灭 的 时 间 
4 notification.flags | = Notification. FLAG SHOW LIGHTS; 


名 第 1~3 行 ,设置 LED 灯 闪烁 的 颜色 和 亮 、 灭 时 间 。 
所 第 4 行 ,设置 LED 灯 按 自 定义 参数 的 方式 进行 闪烁 。 
C) 设置 对 通知 的 单 击 事件 处 理 。 


1 // 设 置 通知 的 事件 消息 

2 Context context = getApplicationContext(); // 上 下 文 

3 CharSequence contentTitle = "My Notification"; // 通 知 栏 标题 

4 CharSequence contentText = "Hello World!"; // 通 知 栏 内 容 

5 Intent notificationIntent = new Intent(this,Main.class); // 单 击 该 通知 后 要 跳 转 的 Activity 
6 PendingIntent contentIntent = PendingIntent. getActivity(this, 0, notificationIntent, 0); 

7 notification. setLatestEventInfo(context, contentTitle, contentText, contentIntent); 

8 // 把 Notification 传递 给 NotificationManager 

9 mNotificationManager. notify(0, notification); 


x8 6 行 ,获取 PendingIntent 对 象 。PendingIntent 就 是 一 个 Intent 的 描述 ,相当 于 对 
Intent 执行 了 包装 ,不 一 定 要 马上 执行 它 , 只 是 将 其 包装 后 ,传递 给 其 他 Activity 或 
Application 。 

38 7 行 , 按 第 2 一 6 行 的 参数 值 设 置 通 知 在 状态 栏 中 的 属性 。 

名 第 9 行 , 向 NotificationManager 对 象 发 送 通知 对 象 notification, 

(4) 发 送 通知 。 

private static final int ID NOTIFICATION = 1; 

mNotificationManager.notify(ID NOTIFICATION, notification); 


289€ Android AANE 


6.2 BroadcastReceiver 组 件 


BroadcastReceiver 类 位 于 android. content 包 下 。BroadcastReceiver 顾名思义 是 广播 的 
接收 器 ,是 一 种 对 广播 消息 进行 过 滤 并 响应 的 控件 。 它 和 事件 处 理 机 制 类 似 , 只 不 过 事件 处 理 
机 制 是 程序 组 件 级 别 的 ,例如 , 某 个 按钮 的 单 击 事件 ,而 广播 事件 处 理 机 制 是 系统 级 别 的 。 例 
如 ,系统 的 时 区 改变 .系统 时 间 改 变 . 电 池 电 量 低 等 。 到 目前 为 止 ,只 介绍 了 使 用 Intent 来 启 
动 一 个 程序 组 件 ,下 面 将 介绍 Intent 的 另外 一 种 用 法 一 一 广播 事件 。 

注意 ,在 程序 中 实现 自己 的 BroadcastReceiver 必须 要 注册 。 


9.2.1 BroadcastReceiver 的 运行 机 制 


BroadcastReceiver 的 运行 机 制 比较 简单 ,首先 是 构建 Intent 对 象 ,然后 调用 sendBroadcast() 
方法 将 广播 发 出 。 当 应 用 程序 注册 了 BroadcastReceiver 之 后 , 当 系 统 或 其 他 应 用 程序 发 送出 
广播 时 ,所 有 已 经 注册 的 就 会 检查 注册 时 的 IntentFilter 是 否 与 发 送 的 Intent 相 匹 配 , 若 匹配 
则 调用 BroadcastReceiver 的 onReceive( ) 方 法 ,在 该 方法 中 响应 事件 。 


1. 发 送 广播 的 方式 


BroadcastReceiver 有 三 种 发 送 方式 ,各 种 发 送 方式 的 不 同 之 处 如 下 。 

1) 使 用 sendBroadcast() 或 sendStickyBroadcast() 方 法 发 送 的 广播 

使 用 sendBroadcast() 或 sendStickyBroadcast( ) 方 法 发 送 的 广播 ,所 有 满足 条 件 的 都 会 执 
行 其 onReceive() 方 法 来 处 理 响 应 ,但 车 有 多 个 满足 条 件 的 BroadcastReceiver 时 ,其 执行 
onReceive() 方 法 的 顺序 是 不 定 的 。 

2) 使 用 sendOrderedBroadcast() 方 法 发 送 的 广播 

使 用 sendOrderedBroadcast() 方 法 发 送出 去 的 Intent, 会 根据 BroadcastReceiver 的 注册 
时 IntentFilter 中 设置 的 优先 级 顺序 地 来 执行 onReceive ( ) 方 法 ,而 相同 优先 级 的 
BroadcastReceiver, 其 执行 onReceive() 方 法 的 顺序 是 不 定 的 。 

3) 使 用 sendStickyBroadcast() 方 法 发 送 的 广播 

sendStickyBroadcast() 方 法 与 其 他 两 种 方法 的 主要 不 同 是 ,Intent 在 发 送 后 会 一 直 存 在 ， 
并 且 在 以 后 调用 registerReceive 注册 相 匹 配 的 Receive 时 会 把 这 个 Intent 直接 返回 给 新 注册 
的 Receive。 


2. 接收 广播 的 过 程 


BroadcastReceiver 的 接收 程序 开发 过 程 如 下 。 
1) 开发 BroadcastReceiver 类 的 子 类 ,并重 写 onReceive() 方 法 
继承 BroadcastReceiver 类 ,并 重 写 onReceive() 方 法 的 代码 段 如 下 : 
public class MyReceiver extends BroadcaseReceiver { 

(2 Override 


Public void onReceive(Context context, Intent intent) { 
//… 在 这 里 定义 事件 响应 处 理 
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在 onReceive() 方 法 里 最 好 不 要 有 执行 超过 5s 的 代码 ,如 果 这 样 ,Android 系统 就 会 弹出 
一 个 超时 对 话 框 。 因 此 ,建议 把 比较 耗 时 的 事件 响应 方法 写 在 一 个 线程 里 ,单独 来 执行 。 

2) 注册 BroadcastReceiver 对 象 

不 管 是 系统 广播 的 Intent 还 是 其 他 程序 广播 的 Intent, 如果 想 接收 并 且 对 它 进行 处 理 , 都 需 
要 注册 一 个 BroadcastReceiver, 并且 一 般 地 要 给 注册 的 这 个 BroadcastReceiver 设置 一 个 
IntentFilter 来 制定 当前 的 BroadcastReceiver 是 对 哪些 Intent 进行 监听 。 注 册 BroadcastReceiver 
有 以 下 两 种 方式 。 

OD 静态 注册 方式 。 

静态 注册 方式 是 在 AndroidManifest. xml fff — application > fj 4 H fS Jl < receiver > bj 
签 ,并 设置 要 接收 的 action。 这 种 方式 比较 常用 。 例 如 对 接收 系统 日 期 改变 完成 广播 的 注册 ， 
其 注册 代码 为 : 

< receiver android:name = ". MyReceiver"> 

< intent - filter> 
<action android:name = "android. intent. action. DATE_CHANGED" /> 
< category android:name = "android. intent. category. HOME" /> 
«/intent- filter» 

«/receiver» 

Android 系统 提供 了 很 多 标准 广播 Action。 这 些 广播 是 系统 自动 发 出 的 ,可 以 在 
去 intentrfilter 之 的 二 action 之 中 直接 使 用 这 些 标 准 广播 常量 。 常 见 的 标准 广播 Action 常量 如 
K 9-3 所 示 。 


表 9-3 常见 的 标准 广播 Action 常量 


常 量 名 常 量 值 *& X 
ACTION BOOT COMPLETED Android. intent, action. BOOT COMPLETED 系统 启动 完成 
ACTION TIME CHANGED Android. intent. action. ACTION TIME CHANGED 时 间 改 变 
ACTION DATE CHANGED Android. intent. action. ACTION DATE CHANGED 日 期 改变 
ACTION TIMEZONE CHANGED Android. intent. action. ACTION TIMEZONE CHANGED ”时 区 改变 
ACTION BATTERY LOW Android. intent. action. ACTION. BATTERY LOW 电量 低 


ACTION_MEDIA_EJECT Android. intent. action. ACTION MEDIA EJECT 插入 或 拔 出 外 部 媒体 


(2) 动态 注册 方式 。 
动态 注册 方式 是 在 Activity 里 通过 调用 registerReceiver( ) 方 法 来 注册 。 例 如 ,同样 地 ,要 
完成 接收 系统 日 期 改变 广播 ,使 用 在 代码 中 直接 注册 ,其 代码 如 下 所 示 。 


// 创 建 相关 对 象 

MyReceiver receiver = new MyReceiver(); 
IntentFilter filter - new IntentFilter(); 
filter.addAction(DATE CHANGED); 


// 动 态 注册 BroadcastReceiver 
registerReceiver(receiver, filter); 


registerReceiver ) 方 法 有 两 个 参数 ,第 一 个 参数 是 指定 接收 器 对 象 ,第 二 个 参数 是 
IntentFilter 对 象 , 其 内 是 要 接收 的 action 属性 。 


289€ Android BANE 


(3) 两 种 注册 方式 比较 。 

现在 已 经 了 解 了 两 种 注册 BroadcastReceiver 的 方式 ,还 需要 了 解 两 种 注册 方式 的 特点 ， 
以 便 在 开发 中 可 根据 应 用 需求 的 场合 来 选择 注册 方式 。 

静态 注册 方式 的 特点 : 在 应 用 程序 安装 之 后 ,无 论 该 应 用 程序 是 否 处 于 活动 状态 ， 
BroadcastReceiver 始终 处 于 被 监听 状态 。 这 种 注册 方式 通常 用 于 监听 系统 状态 的 改变 ,如 手 
机 的 电量 ,日 期 的 改变 ,时 期 的 改变 ,WIFI 网 卡 的 状态 等 。 

动态 注册 方式 的 特点 : 在 代码 中 进行 注册 后 , 当 应 用 程序 关闭 后 ,就 不 再 进行 监听 。 这 样 
注册 的 BroadcastReceiver 通常 用 于 更 新 UI 的 状态 。 一 般 情况 下 ,在 Activity 的 onResume() 
方法 中 使 用 Context. registerReceiver() 方 法 来 注册 一 个 广播 接收 器 ,在 onPause() 方 法 中 使 
用 Context. unregisterReceiver(r) 方 法 来 注销 一 个 广播 接收 器 。 

注册 的 BroadcastReceiver 并 非 一 直 在 后 台 运 行 , 一 旦 当 事 件 或 相关 的 Intent 传 来 ,就 会 
被 系统 调用 ,处 理 onReceive() 方 法 里 的 响应 事件 。 


9.2.2 BroadcastReceiver 的 应 用 案例 


BroadcastReceiver 组 件 没有 提供 可 视 化 的 界面 来 显示 广播 信息 ,但 可 以 使 用 Notification 
来 实现 广播 信息 的 显示 、 提 示 音 、 闪 烁 和 振动 等 消息 提示 。 下 面 是 一 个 使 用 BroadcastReceiver 
和 Notification, NotificationManager 的 综合 案例 。 

【案例 9. 2〗 通过 一 个 按钮 来 发 出 一 个 广播 信息 ,并 将 它 显 示 在 状态 栏 中 。 也 可 以 单 击 
一 个 按钮 ,清除 状态 栏 中 的 通知 信息 。 

【说 明 】 这 是 用 户 自己 定义 的 BroadcastReceiver 发 送 广播 的 案例 ,而 非 系统 级 的 广播 ， 
所 以 在 程序 代码 中 使 用 registerReceiver() 方 法 动态 地 注册 BroadcastReceiver 的 方式 。 

本 例 应 用 需要 定义 两 个 程序 类 ,一 个 是 Activity 类 ,在 其 中 构建 案例 中 需要 广播 的 
Intent, 然 后 在 按钮 的 onClick() 方 法 中 使 用 sendBroadcast() 方 法 发 送出 去 ,并 且 在 该 类 的 
onResume() 方 法 中 注册 广播 接收 器 。 另 一 个 是 继承 BroadcastReceiver 的 子 类 ,在 该 子 类 的 
onReceive() 方 法 中 将 传人 的 广播 Intent 中 的 信息 发 送 给 一 个 通知 对 象 。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 BroadcastRec_Demo 的 Android 项 目 。 其 应 
用 程序 名 为 BroadcastRec. 包 名 为 cn. com. sgmsc. broadcastreceiver, Activity 组 件 名 为 
BroadcastRec_DemoActivity。 

(2) 准备 图 片 。 将 用 于 通知 的 图 标的 图 片 资源 复制 到 本 项 目的 res/drawable-mdpi 目 
录 中 。 

(3) 准备 字符 串 资源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 

2 «resources» 

3 
4 < string name = "hello"> Hello World, BroadcastRec DemoActivity!«/string? 

5 < string name = "app name"» BroadcastReceiver «/string? 

6 < string name = "btnsend"> 发 送 广播 </string> 

7 < string name = "btnclr"> 清 除 通知 </string> 

8 < string name = "brdcast"> 这 是 BroadcastReceiver 发 出 的 广播 。</string> 

9 
1i 


0 «/resources > 
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CD 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 


<?xml version = "1.0" encoding = "utf - 8"?> 
< LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
android:orientation = "vertical" 


android:layout width- "fill parent" 
android:layout height = "fill parent" > 

< TextView 
android:layout width- "fill parent" 

:layout height = "wrap content" 
android: text = "(Ustring/app name" 
android:gravity- "center horizontal" 
android:padding - "10sp" 
android:textSize = "8pt" 
android:textColor = " #00FF00" /> 

< Button android: id - "(3 + id/BTN SEND" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
android:text = "(Ostring/btnsend" /> 

« Button android: id - "(3 + id/BTN CLEAR NOTIFICATION" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
android: text = "(Qstring/btnclr" /> 

«/LinearLayout > 


androi 


两 个 按钮 显示 的 文本 取 自 于 strings. xml 文件 。 
(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. broadcastreceiver 包 下 的 BroadcastRec_ 
DemoActivity. java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. broadcastreceiver; 


import android. app. Activity; 

import android. app. NotificationManager; 
import android. content. Intent; 

import android. content. IntentFilter; 
import android. os. Bundle; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 


public class BroadcastRec DemoActivity extends Activity implements OnClickListener { 


public static final String ACTION = "cn. com. sgmsc.action. BroadcastReceiver" ; 
// 定 义 IntentFilter 的 action 
public static final String INTENT EXTRAS TITLE = "BroadcastReciver Demo Activity."; 


private MyReceiver mReceiver - null; 
private IntentFilter mIntentFilter - null; 


(GOverride 

protected void onCreate(Bundle icicle) ( 
super. onCreate( icicle); 
setContentView(R. layout. main); 
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Button btnSend = (Button)findViewById(R. id. BTN_SEND);  //“ 发 送 广播 ?按钮 
Button btnClear = (Button)findViewById(R. id.BTN CLEAR NOTIFICATION); 


/A* 清 除 通 知 ” 按 钮 
btnSend. setOnClickListener(this); 
btnClear. setOnClickListener(this); 
} 
@Override 
protected void onResume() { 
mReceiver = new MyReceiver(); 
mIntentFilter - new IntentFilter(); 
mIntentFilter.addAction(ACTION); // |i] nIntentFilter 中 添加 action 属性 值 
this.registerReceiver(mReceiver, nIntentFilter); // 注 册 接收 器 
super. onResune( ) ; 
) 
(QOverride 
protected void onDestroy() ( 
if(mReceiver != null) ( // 注 销 接收 器 
this. unregisterReceiver(mReceiver); 
}; 
super. onDestroy() ; 
} 
@Override 


public void onClick(View v) { 
switch(v.getId() ) { 

case R. id. BTN_SEND: { 
doSend() ; 
break; 

) 

case R. id.BTN CLEAR NOTIFICATION: { 
doclearnotification(); 
break; 


private void doSend() { 
Intent sendIntent = new Intent(ACTION); 
sendIntent.putExtra("extit", INTENT EXTRAS TITLE); 
sendIntent. putExtra("exmsg" , getString(R. string. brdcast).toString()); 
this.sendBroadcast(sendIntent); // 广 播发 送 一 个 Intent 对 象 sendIntent 


private void doclearnotification() { 
NotificationManager notificationManager - (NotificationManager) 
this.getSystemService(android. content. Context. NOTIFICATION SERVICE); 
notificationManager.cancel(MyReceiver. NOTIFICATION ID); 
// 清 除 ID 5J NOTIFICATION ID 的 通知 


(D 第 12 行 定义 这 个 Activity 类 实现 OnClickListener 接口 。 在 该 接口 内 重 定 义 了 
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onClick( 


) 方 法 , 当 单 击 “ 发 送 广 播 ” 按 钮 时 执行 doSend() 方 法 ,该 方法 在 第 62 一 67 行 定义 。 当 


单 击 “ 清 除 通 知 ” 按 钮 时 执行 doclearnotification() 方 法 ,该 方法 在 第 69 一 73 行 定义 。 
© 第 32 一 38 行 重 写 了 onResume() 方 法 ,在 该 方法 中 使 用 registerReceiver() 方 法 注册 广 


播 接收 器 。 

© 58 41—46 行 重 写 了 onDestroy() 方 法 ,在 该 方法 中 使 用 unregisterReceiver( ) 方 法 注销 
了 广播 接收 器 。 

(6) 开发 MyReceiver 类 代码 。 在 src/cn. com. sgmsc. broadcastreceiver 包 下 创建 一 个 代 


码 文件 


MyReceiver. java, 该 文件 是 定义 一 个 广播 接收 器 类 MyReceiver, 它 继 承 自 


BroadcastReceiver 类 ,并 且 重 写 onReceiver() 方 法 ,在 该 方法 内 编写 响应 接收 广播 的 事件 。 其 
代码 如 下 所 示 。 


package cn. com. sgmsc. broadcastreceiver; 


import android. app. Notification; 
import android. app. NotificationManager; 


import android. content. BroadcastReceiver; 
import android. content. Context; 
import android. content. Intent; 


R 
2 
3 
4 
5 import android. app. PendingIntent; 
6 
* 
8 
9 


10 p 


11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 } 


(0) 


ublic class MyReceiver extends BroadcastReceiver { 
Context context; 
public static int NOTIFICATION ID - 21321; 


(QOverride 
public void onReceive(Context context, Intent intent) { 
this.context = context; 
// 从 传人 的 Intent 对 象 中 取出 该 Intent 附加 的 信息 
String titstr = intent.getStringExtra("extit"); 
String msgstr = intent.getStringExtra("exnsg"); 


// 获 得 NotificationManager 的 实例 
NotificationManager notificationmanager = (NotificationManager) context 
.getSystemService(android. content. Context. NOTIFICATION SERVICE); 
// 实 例 化 Notification 
Notification notification = new Notification(R.drawable. ic header, 
titstr, System.currentTimeMillis()); 
// 获 得 PendingIntent 对 象 
PendingIntent pintent = PendingIntent.getActivity(context, 0, 
new Intent(context, BroadcastRec DemoActivity.class), 0); 
// 设 置 事件 信息 
notification. setLatestEventInfo(context, msgstr, null,pintent); 
// 发 出 ID Jg NOTIFICATION ID 的 通知 
notificationmanager. notify(NOTIFICATION_ID, notification); 


静态 注册 广播 接收 器 的 代码 。 本 例 是 在 代码 中 动态 注册 BroadcastReceiver 的 。 如 


果 想 使 用 静态 注册 的 方法 , 则 在 AndroidManifest. xml 文件 中 声明 。 具 体 的 代码 见 该 
AndroidManifest. xml 文件 的 第 21 一 26 行 的 注释 部 分 。 


$89: 《Android 后 台 处 理 


1 <?xml version = "1.0" encoding- "utf - 8"?> 
2 «manifest xnlns:android- "http: //schemas. android. con/apk/res/android" 


3 package 7 "cn. con. sgnsc. broadcastreceiver" 

4 android:versionCode = "1" 

5 android:versionName = "1.0" > 

6 

7" < uses - sdk android:minSdkVersion = "10" /> 

8 

9 X application 

10 android: icon = "(Qdrawable/ic launcher" 

11 android: label = "@string/app_name" > 

12 <activity 

13 android: label = "@string/app_name" 

14 android:name = ".BroadcastRec DemoActivity" > 

15 < intent - filter > 

16 <action android:name = "android. intent. action. MAIN" /> 
17 < category android:name = "android. intent. category. LAUNCHER" /> 
18 </intent - filter > 

19 </activity> 

20 

21 <! -- receiver android:name = ".MYReceiver"> 

22 < intent ~ filter» 

23 <action 

24 android:name = "cn. com. sgmsc. action. BroadcastReciver"/> 
25 </intent - filter > 

26 </receiver --> 

27 

28  «/application» 

29 


30 </manifest > 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ， 
初始 运行 的 显示 效果 如 图 9-4 所 示 。 当 单 广播 ”按钮 后 , 自 定义 的 广播 接收 器 接收 广 
播 的 Intent, 并 将 传人 的 信息 显示 在 状态 条 中 ,如 图 9-5 所 示 。 当 拉 下 状态 条 ,出 现状 态 栏 信 
息 , 如 图 9-6 所 示 。 当 单 击 “清除 通知 ?按钮 后 ,状态 条 中 的 信息 被 清除 ,如 图 9-7 所 示 。 


图 9-5 单 击 “发 送 广播 按钮 后 
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Android 


A. 这 是 BroadcastReceiver 发 出 的 广播. 


BroadcastRecelver 


图 9-6 拉 下 状态 条 时 显示 的 通知 信息 图 9-7 单 击 “ 清 除 通知 ”按钮 后 


9.3 Android 后 台 线 程 


当 一 个 程序 第 一 次 启动 时 ,Android 会 启动 一 个 Linux 进程 和 一 个 主线 程 (Main Thread) 。 
线程 是 比 进程 更 小 的 执行 单位 。 

主线 程 主要 负责 处 理 与 UI 相关 的 事件 ,如 用 户 的 按键 事件 .用户 接 触 屏 幕 的 事件 以 及 屏 
幕 绘图 事件 ,等 等 ,并 把 相关 的 事件 分 发 到 对 应 的 组 件 进行 处 理 。 所 以 主线 程 通常 又 被 叫 作 
UI 线程 。 在 开发 Android 应 用 时 必须 遵守 单线 程 (Single-threaded) 模 型 的 原则 : Android UI 
操作 并 不 是 线程 安全 的 ,并 且 这 些 操作 必须 在 UI 线程 中 执行 。 

所 有 非 主线 程 就 是 子 线程 , 子 - 般 都 是 后 台 线 程 , 它 是 由 用 户 在 程序 中 定义 的 。 由 于 
Android 的 UI 是 单线 程 的 ,为 了 保证 应 用 程序 的 响应 效率 ,一 般 使 用 后 台 线程 ,把 所 有 运行 慢 


的 、 耗 时 的 操作 移出 主线 程 , 放 到 子 线 程 中 。 例 如 ,Activity 在 5s 内 不 响应 任何 输入 事件 ,或 
者 Broadcast Receiver 在 5s 后 仍 未 完成 onReceive 的 处 理 操作 ,等 等 。 


在 子 线程 中 操作 UI 对 象 是 不 安全 的 。 如 果 后 台 的 子 线程 执行 了 UL 对 象 ,Android 就 会 

发 出 错误 信息 CalledFromWrongThreadException。 为 了 解决 后 台子 线程 与 UI 线程 间 的 信 

息 交 互 问 题 ,Android 设计 了 一 种 Handler 消息 传递 机 制 或 AsyncTask 后 台 运 行事 务 ,来 处 理 
线程 之 间 的 数据 传递 问题 。 


9.3.1 Handler 消息 传递 机 制 
1. Handler 类 


Handler 类 位 于 android. os 包 下 。 它 负责 消息 (Message) 的 发 送 , 消 息 内 容 的 执行 处 理 ， 
主要 完成 Android 的 Widget 与 应 用 程序 中 子 线程 之 间 的 交互 。 自 定义 的 后 台 线 程 可 与 
Handler 通信 ,一 个 Handler 对 应 一 个 Activity. Handler 将 与 UI 线程 一 起 工作 。 

消息 (Message) 可 以 理解 VARMANA. 消息 队列 (Message Queue) 则 是 用 来 存 
放 通 过 Handler 发 布 的 消息 ,每 个 消息 队列 都 会 有 一 个 对 应 的 Handler, 按 照 先进 先 出 执行 。 
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Handler 的 常用 方法 如 表 9-4 所 示 。 
表 9-4 Handler 中 的 常用 方法 及 说 明 


方 d 返回 值 描 x 
handlerMessage( Message msg) void 子 类 对 象 通过 该 方法 接收 消息 
sendEmptyMessage(int what) boolean 发 送 一 个 只 含有 what 值 的 消息 
sendMessage( Message msg) boolean 发 送 消 息 到 Handler 
hasMessages(int what) boolean 监测 消息 队列 中 是 否 还 有 what 值 的 消息 
Post(Runnable r) boolean 将 一 个 线程 添加 到 消息 队列 中 


2. Handler 类 的 使 用 


开发 带 有 Handler 类 的 程序 步骤 如 下 。 

(1) 在 Activity 或 Activity 的 Widget 中 开发 Handler 类 的 对 象 , 重 写 handlerMessage() 
方法 。 

(2) 在 新 启动 的 线程 中 调用 sendEmptyMessage() 或 sendMessage() 方 法 向 Handler 发 
送 消息 。 

(3) Handler 类 的 对 象 用 handlerMessage( ) 方 法 接收 消息 ,然后 根据 消息 执行 相应 的 
操作 。 

下 面 通过 一 个 Handler 使 用 案例 来 介绍 其 用 法 。 

【案例 9.3】 使 用 Handler 机 制 以 幻灯 片 的 形式 显示 IT 界 的 名 人 照片 ,每 张 图 片 停 
留 3s。 

DAJ 本 例 使 用 两 个 类 来 定义 代码 ,一 个 是 Activity 类 ,在 其 中 构建 Handler 对 象 ,并 
重 写 handlerMessage() 方 法 ,在 该 方法 内 根据 消息 的 值 确定 UT 的 显示 内 容 。 另 一 个 是 继承 
Thread 的 子 类 ,并重 写 run() 方 法 ,在 该 方法 内 使 用 sendEmptyMessage() 方 法 向 Handler 发 
送 消息 。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ThreadDemo 的 Android 项 目 。 其 应 用 程序 名 为 
ThreadDemo, 包 名 为 cn. com. sgmsc. threaddemo, Activity 组 件 名 为 ThreadDemoActivity。 

(2) 准备 图 片 。 将 要 显示 的 图 片 资源 复制 到 本 项 目的 res/ drawable-mdpi 目录 中 。 

(3) 准备 字符 串 资 源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 < resources > 


3 

4 < string name = "hello"> Hello World, ThreadDemoActivity!</string> 
5 < string name = "app_name"> ThreadDemo </string> 

6 

7 < string name = "title"> IT 界 名 人 </string> 

8 < string name = "andy"> Andy Rubin, Android 的 创始 人 之 一 。</string> 


9 < string name = "bill"> Bill Joy, Java 创造 者 之 一 。</string> 

10 < string name = "edgar"> Edgar F. Codd, 关系 数据 库 之 父 。</string> 

11 < string name = "torvalds"> Linus Torvalds,Linux 系统 的 创始 人 。</string> 
12 < string name = "turing"> Turing Alan, IT HHI. </string> 

13 </resources > 
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(4) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 。 在 这 里 使 用 RelativeLayout 


布局 ,代码 如 下 所 示 。 


Java 


1 <?xml version= "1.0" encoding = "utf - 8"?> 
2 <RelativeLayout 
3 xmlns:android = "http: //schemas. android. con/apk/res/android" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:layout margin = "2dip"> 

7 

8 < TextView 

9 android:id- "(à + id/picTitle" 

10 android:layout width- "wrap content" 
11 android:layout height = "50dip" 

12 android:layout alignParentTop = "true" 
13 android:layout centerHorizontal = "true" 
14 android:gravity = "center vertical" 

15 android:textSize = "22sp" 

16 android:textColor = " &ffffff00" 

17 android:text = "(üstring/title" /> 

18 

19 < InageView 

20 android:id - "(9 + id/myPic" 

21 android:layout width- "fill parent" 

22 android:layout height = "fill parent" 
23 android:layout below = "(3)id/picTitle" 
24 android:layout alignParentTop = "true" 
25 android:layout alignParentLeft = "true" 
26 android:src = "(Zdrawable/andy" /> 

27 

28 < TextView 

29 android:id- "(à + id/picName" 

30 android:layout width- "fill parent" 

31 android:layout height - "50dip" 

32 android:layout alignParentBottom - "true" 
33 android:layout alignParentLeft - "true" 
34 android:gravity = "center" 

35 android:background = " £55ffff00" 

36 android:textSize - "18sp" 

37 android:text = "(9 string/andy" /> 

38 


39 «/RelativeLayout» 


CO 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. threaddemo 包 下 的 ThreadDemoAcctivity. 
文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. threaddemo; 


import android. os. Handler; 
import android. os. Message; 
//…… 省略 了 部 分 引入 类 


public class ThreadDemoActivity extends Activity { 
ImageView myPicture; //1nageView 的 引用 
TextView myPicname; //TextView 的 引用 


eonan wne 
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10 Handler myHandler = new Handler()( // 创 建 一 个 Handler 对 象 
1l (2 0verride 

A2 public void handleMessage(Message msg) ( // 重 写 接收 消息 的 方法 
13 switch(msg. what){ // 判 断 what 的 值 

14 case 0: //what 值 为 0 时 

15 myPicture. setImageResource(R. drawable. andy); 

16 myPicname. setText(R. string.andy); 

17 break; 

18 case 1: //what 值 为 1 时 

19 myPicture. setImageResource(R. drawable.bill); 

20 myPicname. setText(R. string.bill); 

21 break; 

22 case 2: //what 值 为 2 时 

23 myPicture. set ImageResource(R. drawable. edgar); 

24 myPicname. setText(R. string. edgar); 

25 break; 

26 case 3: //what 值 为 3 时 

27 myPicture. setImageResource(R. drawable. torvalds); 

28 myPicname. setText(R. string. torvalds); 

29 break; 

30 case 4: //what 值 为 4 时 

31 myPicture. setImageResource(R. drawable. turing); 

32 myPicname. setText(R. string. turing); 

33 break; 

34 } 

35 super. handleMessage(msg) ; 

36 } 

37 fi 

38 @Override 

39 public void onCreate(Bundle savedInstanceState) { // 重 写 的 onCreate( ) 方 法 
40 super. onCreate(savedInstanceState); 

41 setContentView(R. layout. main); // 设 置 当前 的 用 户 界 面 
42 myPicture = (ImageView) findViewById(R. id. nyPic); // 得 到 ImageView 的 引用 
43 myPicname = (TextView) findViewById(R. id. picName);  // 得 到 ImageView 的 引用 
44 MyThread myThread = new MyThread(this); // 初 始 化 MyThread 线程 
45 nyThread. start() ; // 启 动 线程 

46 ) 

47 

48 } 


(D 第 10 一 37 行 创 建 一 个 Handler Xf ££ myHandler.Jf 3 5j f handleMessage O Jy} ,在 
该 方法 中 根据 传人 的 message 的 what ff ,确定 ImageView 和 TextView 中 的 显示 内 容 。 

© 第 45 行 ,在 onCreate() 方 法 中 启动 线程 。 

(6) 开发 MyThread 类 代码 。 在 src/cn. com. sgmsc. threaddemo 包 下 创建 一 个 代码 文件 
MyThread. java, 该 文件 是 定义 一 个 线程 类 MyThread, 它 继承 自 Thread 类 ,并 且 重 写 run() 
方法 ,其 代码 如 下 所 示 。 


1 package cn. com. sgmsc.threaddemo; 

2 

3 public class MyThread extends Thread( 

4  ThreadDemoActivity activity; //Activity 的 引用 

5 intwhat = 1; // 发 送 消息 的 what 值 
6 public MyThread(ThreadDemoActivity activity){ // 构 造 器 

" 


this.activity = activity; // 得 到 Activity 的 引用 
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8 i] 

9 @Override 

10 public void run() { // 重 写 的 run( ) 方 法 
ax while(true)( // 循 环 

12 activity.myHandler.sendEmptyMessage((what-*) %5); // 发 送 消息 

13 try{ 

14 Thread. sleep(3000) ; / / BEWK 

15 } 

16 catch(Exception e)( // 捕 获 异常 

17 e. printStackTrace( ); // 打 印 异常 信息 
18 } 

19 } 

20 ) 

21] 


第 10—20 行 ,在 run() 方 法 中 执行 一 个 循环 ,使 用 sendEmptyMessage O 77 3 f$ [fà 3s 向 
Activity 的 myHandler 中 发 送 一 个 消息 值 , 该 值 由 表达 式 (what 十 十 )%5 计算 ,其 计算 结果 是 


0,1,2,3,4。 
【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 ThreadDemo 项 目 。 运 行 结果 


是 以 3s 的 时 间 间 隔 逐 一 显示 资源 中 提供 的 人 物 照片 ,并且 循环 往复 。 其 显示 效果 如 图 9-8 和 
图 9-9 所 示 。 


ThreadDemo 


"Threadbemo 


IT 界 名 人 


图 9-8 显示 的 第 一 张 照片 图 9-9 3s 后 显示 的 第 二 张 照片 
当然 ,也 可 以 在 同一 个 Activity 中 定义 子 线程 。 在 第 6 章 案例 6. 3 中 ,就 是 这 样 实现 线程 


通信 的 。 下 面 来 重 温 其 相关 代码 。 在 Eclipse 中 展开 项 目 Activity Dialog. 打开 cn. com. 
sgmsc. dialog 包 下 的 DialogActivity. java 文件 ,与 子 线程 相关 的 代码 片断 如 下 。 


public class DialogActivity extends Activity { 
//… 省 略 部 分 对 象 、 变 量 的 引用 声明 


1 package cn. com. sgnsc. dialog; // 声 明 包 语句 
2 

3 //…… 省 略 了 部 分 引入 类 

4 import android. os. Handler; // 引 入 相关 类 
5 import android. os. Message; // 引 入 相关 类 
6 

T 

8 


57 
58 ) 


ProgressDialog pd; 
Handler myHandler; 


(2 Override 
public void onCreate(Bundle savedInstanceState) { 
//…… 省 略 部 分 初始 化 代码 
myHandler = new Handler(){ 
@Override 
public void handleMessage(Message msg) ( 
switch(msg. what) { 
case INCREASE: 
pd. incrementProgressBy(1); 
if(pd.getProgress()» - 100)( 
pd. disniss(); 
) 
break; 


i 
super. handleMessage(nmsg) ; 


}; 
} 


//…… 省 略 部 分 代码 段 


@Override 
public void onPrepareDialog(int id, Dialog dialog) { 
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/ [Handler 对 象 引 用 


// 创 建 Handler 对 象 


// 进 度 每 次 加 1 
// 判 断 是 否 结束 进度 
// 如 果 进 度 条 走 完 则 关闭 窗口 


// 每 次 弹出 对 话 框 时 更 新 对 话 框 内 容 的 方法 


super. onPrepareDialog( id, dialog); 
switch(id)( 
case PROGRESS DIALOG: 


pd. incrementProgressBy( - pd. getProgress()); 


new Thread()( 
public void run(){ 
while(true)( 


myHandler. sendEnptyMessage( INCREASE) ; 


if(pd.getProgress()» = 100) ( 
break; 
) 
try{ 
Thread. sleep( 40); 
} 
catch(Exception e){ 
e. printStackTrace(); 
} 
} 
} 
).start(); 
break; 


// 对 话 框 进度 清 零 
// 创 建 一 个 线程 


// 发 送 Handler 消息 


// 线 程 休眠 


// 捕 获 并 打印 异常 


// 启 动 线程 


(D 第 10—20 ÍT. E onCreate() 方 法 中 创建 一 个 Handler 对 象 myHandler, 并 根据 消息 指 
令 , 如 果 消 息 为 INCREASE, 那 么 在 进度 条 未 到 达 终 点 时 就 让 进度 条 前 进 一 格 进度 ,否则 退出 
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进度 条 对 话 框 。 

© 第 39—54 行 创建 了 一 个 匿名 线程 ,在 该 线 内 重 写 了 run() 方 法 。 第 54 行 , 该 线程 一 经 
创建 即刻 启动 。 

看 上 去 ,这 种 匿名 线程 定义 简单 ,不 需要 另外 定义 继承 子 类 。 但 是 这 种 匿名 线程 的 方式 是 
存在 缺陷 的 : 第 一 ,线程 的 开销 较 大 ,如 果 每 个 任务 都 要 创建 一 个 线程 ,那么 应 用 程序 的 效率 
要 低 很 多 ; 第 二 ,线程 无 法 管理 ,匿名 线程 创建 并 启动 后 就 不 受 程 序 的 控制 了 ,如 果 有 很 多 个 
请 求 发 送 ,那么 就 会 启动 非常 多 的 线程 ,系统 将 不 堪 重 负 。 另 外 ,前 面 已 经 看 到 ,在 新 线程 中 更 
新 UI 还 必须 要 引入 Handler, 这 让 代码 看 上 去 非常 腔 肿 。 为 了 解决 这 一 问题 ,Android 引入 
了 AsyncTask, 


9.3.2 AsyncTask 


1. AsyncTask 类 


AsyncTask 是 抽象 类 ,位 于 android. os 包 下 。 顾 名 思 义 ,AsyncTask 是 异步 任务 的 意思 ， 
它 是 一 种 简单 的 实现 后 台 运 行事 务 的 方式 。 异 步 任务 是 Android 1. 5 引入 的 一 个 新 特性 ,UI 
线程 可 以 把 某 些 操作 留 给 后 台 运 行 的 线程 去 运行 ,Android 自动 新 建 和 删除 后 人 台 线程 ,无 须 开 
发 者 显 式 地 实现 。 所 以 ,AsyncTask 的 特点 是 任务 在 UI 线程 之 外 运行 ,而 回调 方法 是 在 UI 
线程 中 执行 ,这 就 有 效 地 避免 了 使 用 Handler 带 来 的 麻烦 。 使 用 AsyncTask 类 可 以 将 耗 时 的 
操作 放 在 后 台 来 处 理 ,而 不 需要 人 为 地 另 开 线程 或 者 使 用 Handlers 来 完成 。 

AsyncTask 是 一 个 抽象 类 ,要 使 用 这 个 类 则 必须 通过 继承 该 类 的 子 类 , 重 写 其 中 的 方法 。 
下 面 是 这 个 类 中 常常 需要 重 写 的 一 些 方法 ,如 表 9-5 所 示 。 

表 9-5 AsyncTask 类 需要 重 写 的 方法 及 说 明 


方 法 Hx 
onPreExecute() 当 任 务 执行 之 前 开始 调用 此 方法 ,可 以 在 这 里 显示 进度 对 话 框 
doInBackground(Params...) 此 方法 在 后 台 线程 执行 ,完成 任务 的 主要 工作 ,通常 需要 较 长 的 时 间 。 
在 执行 过 程 中 可 以 调用 


publicProgress( Progress...) 更 新 任务 的 进度 
onProgressUpdate(Progress...) ”此 方法 在 主线 程 执 行 ,用 于 显示 任务 执行 的 进度 
onPostExecute( Result) 此 方法 在 主线 程 执行 ,任务 执行 的 结果 作为 此 方法 的 参数 返回 


开发 时 ,在 AsyncTask 子 类 中 必须 实现 抽象 方法 doInBackground(Params… p) ,这 个 方 
法 是 必须 要 重 写 的 ,用 来 在 后 台 线程 中 处 理 一 些 耗费 时 间 的 事情 , 当 这 个 方法 执行 完毕 后 会 返 
回 一 个 值 ,这 个 值 是 onPostExecute(Object res) 方 法 的 参数 ,也 就 是 说 doInBackground ) 方 
法 运行 结束 后 传递 参数 给 onPostExecute() 交 由 其 执行 。 当 然 在 doInBackground() 中 可 以 调 
用 publishProgress() 方 法 传递 参数 ,这 些 值 将 会 在 onProgressUpdate() 方 法 中 来 实现 UI R 
程 中 控件 信息 的 更 新 。 

AsyncTask 中 有 三 个 参数 ,例如 class MyTask extends AsyncTask-— Params, Progress. 
Result —(). it — 4 2 BUE — Bri X EAE COUR IB CA CS Ri C "GR SE oe 
去 参数 名 之 ”。 它 们 被 用 于 一 个 异步 任务 。 在 一 个 异步 任务 里 ,不 是 所 有 的 类 型 总 被 用 。 假 如 
一 个 类 型 不 被 使 用 ,可 以 简单 地 使 用 Void 类 型 来 蔡 代 , 例如 doInBackground (Void… 
Params) 。 这 里 ,三 个 参数 的 作用 如 下 。 
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(1) Params: 当 执 行 时 ,向 后 台 任 务 的 执行 方法 传递 参数 的 类 型 ,例如 HTTP 请 求 
的 URL。 
(2) Progress: 在 后 台 任 务 执行 过 程 中 ,要 求 主 UI 线程 处 理 中 间 状 态 ,通常 是 一 些 UI 处 
理 中 传递 的 参数 类 型 ,例如 在 后 台 计算 期 间 , 后 台 任务 执行 的 百分比 。 
(3) Result; 后 台 任 务 执行 完 返 回 时 的 参数 类 型 ,后 台 计 算 的 结果 类 型 ,例如 String. 
AsyncTask 类 除了 上 述 需要 重 写 的 方法 外 ,还 有 一 些 常 用 的 公共 方法 ,如 表 9-6 Bron. 
表 9-6 AsyncTask 中 常用 的 方法 及 说 明 


方法 返回 值 描 á g 

cancel (boolean boolean 尝试 取消 这 个 任务 的 执行 。 如 果 此 任务 不 能 取消 返 

mayInterruptIfRunning) 回 false, 如 果 已 经 正常 执行 完毕 ,返回 true 

execute (Params..params) ^— AsyncTask 用 指定 的 参数 来 执行 此 任务 ,这 个 方法 将 会 返回 此 任 
务 本 身 。 此 方法 必须 在 UI 线 程 中 调用 

get (long timeout, TimeUnit Result 等 待 计算 结束 并 返回 结果 ,最 长 等 待 时 间 为 : timeout 

unit) (超时 时 间 ) 

getStatus () AsyncTask. Status 获得 任务 的 当前 状态 

isCancelled O boolean 如 果 在 任务 正常 结束 之 前 取消 任务 成 功 则 返回 true, 
否则 返回 false 


2. AsyncTask 的 使 用 步骤 


AsyncTask 的 执行 分 为 若干 步骤 ,每 一 步 都 对 应 一 个 回调 方法 ,这 些 方法 需要 重 写 。 注 
意 : 在 任务 的 执行 过 程 中 ,这 些 方法 不 由 应 用 程序 调用 ,而 是 被 自动 调用 的 。 

一 个 AsyncTask 运行 的 过 程 中 ,经 历 了 以 下 4 个 步骤 。 

1) onPreExecute() 

在 execute 调用 后 立即 在 UI 线程 中 执行 。 这 步 通 常 被 用 于 设置 任务 ,例如 在 用 户 界 面 显 
示 一 个 进度 条 。 

2) doInBackground( Params...) 

当 onPreExecute() 执 行 完 成 后 ,立即 在 后 台 线程 中 运行 。 这 步 被 用 于 执行 较 长 时 间 的 后 
台 计 算 。 蜡 步 任务 的 参数 也 被 传 到 这 步 。 计 算 的 结果 必须 在 这 步 返回 ,将 传 回 到 上 一 步 。 在 
执行 过 程 中 可 以 调用 publishProgress(Progress...) 来 更 新 任务 的 进度 。 

3) onProgressUpdate( Progress...) 

在 调用 publishProgress 后 ,在 UI 线程 中 运行 。 执 行 的 时 机 是 不 确定 的 。 这 个 方法 用 于 
当 后 台 计 算 还 在 进行 时 在 用 户 界面 显示 进度 。 例 如 : 这 个 方法 可 以 被 用 于 一 个 进度 条 动画 或 
在 文本 域 显示 日 志 。 

4) onPostExecute( Result) 


当 后 台 计 算 结 束 时 ,调用 UI 线程 。 后台 计算 结果 作为 一 个 参数 传递 到 这 步 。 
3. AsyncTask 的 使 用 规则 


因为 AsyncTask 的 特殊 性 ,很 多 开发 工作 都 被 省 略 了 ,如 下 工作 是 不 需要 开发 者 来 完成 
的 : 产生 自己 的 后 台 线 程 ; 在 适当 的 时 候 终 止 后 台 线 程 等 。AsyncTask 具有 fire-and-forget 
(发 射 后 自 寻 ) 的 特性 ,就 是 线程 产生 后 不 用 用 户 干涉 ,全 部 自发 完成 。 所 以 在 编程 中 ,必须 遵 
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守 一 些 线程 规则 ,AsyncTask 类 才能 正确 工作 。 具 体 的 规则 如 下 。 

(1) AsyncTask 任务 实例 必须 创建 在 UI 线程 中 。 

(2) execute(Params...) 必 须 在 UI 线程 上 调用 。 

(3) 不 要 手动 调用 onPreExecute C) , onPostExecute (Result)、dolInBackground (Params...)、 
onProgressUpdate(Progress...) 方 法 。 

(4) 每 个 AsyncTask 只 能 有 一 个 实例 被 执行 ,同时 运行 两 个 以 上 的 AsyncTask ,将 会 抛 
出 异常 。 


4. AsyncTask 的 应 用 


下 面 通过 一 个 简单 的 例子 来 说 明 使 用 AsyncTask 完成 后 台 操作 任务 的 整个 过 程 。 

【案例 9.4】 使 用 AsyncTask 来 完成 进度 对 话 框 的 进度 更 新 操作 。 

[588] 由 于 使 用 AsyncTask, 任 务 在 后 台 运 行 ,在 前 台 界 面 是 看 不 到 后 台 执行 过 程 的 ， 
本 例 在 代码 中 增加 了 输出 Log 的 操作 ,便于 读者 看 到 其 执行 过 程 。 

问 一 下 : 

怎样 实现 输出 Log? 

使 用 android. util 的 Log 类 可 以 实现 Android 输出 Log 这 一 操作 。android. util. Log 常 
用 的 方法 有 以 下 5 个 : Log. vCString tag,String text) ,Log. dC String tag, String text) , Log. i 
(String tag, String text) ,Log. w(String tag.String text) VUA Log. e(String tag.String text). 
根据 首 字母 对 应 VERBOSE.DEBUG.INFO. WARN.ERROR, 

不 同 的 方法 在 logCat 里 面 显 示 文 本 的 颜色 不 同 。Log. v 的 输出 颜色 为 黑色 的 ,任何 消息 
都 会 输出 ; Log. d 的 输出 颜色 是 蓝 色 的 , 仅 输出 调试 信息 ; Log.i 的 输出 为 绿色 ,是 一 般 提 示 
性 的 消息 ; Log. w 的 输出 为 橙色 ,是 一 些 警 告 信息 ; Log.e 为 红色 ,是 一 些 错误 信息 。 

在 Eclipse 的 控制 台 的 LogCat 窗口 中 可 以 看 到 Log 信息 。 调 出 LogCat 窗口 的 方法 是 : 
选择 菜单 Window- Show View- LogCat. 35 3 Ok 按钮 时 ,会 在 控制 台 窗 口中 出 现 LogCat 
窗口 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 AsyncTask_PgDialog 的 Android 项 目 。 其 应 
用 程序 名 为 ProgressDialog_AT, 包 名 为 cn. com. sgmsc. asynctask_PGD, Activity 组 件 名 为 
AsyncTask_PgDialogActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 。 其 代码 如 下 所 示 。 

1 <?xml version = "1.0" encoding= "utf - 8"?» 


2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:gravity- "center horizontal" 

" 2 

8 

9 « Button 

10 android:text = "显示 进度 对 话 框 " 

11 android: id= "@ + id/Button01" 

12 android:layout width- "wrap content" 


13 android:layout height = "wrap content" 


289€ Android BANE 


14 人 > 
35 
16 «/LinearLayout > 


(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. asynctask_ PGD 包 下 的 AsyncTask _ 
PgDialogActivity. java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgmsc. asynctask PGD; 


i 

2 

3 import android. app. Activity; 

4 import android. os. AsyncTask; 

5 import android. os. Bundle; 

6 import android. os. SystemClock; 
7 import android. util. Log; 

8 import android. view. View; 

9 import android. widget. Button; 
10 import android. widget. Toast; 
11 import android. app. Dialog; 

12 import android. app. ProgressDialog; 


14 public class AsyncTask_PgDialogActivity extends Activity { 
15 ProgressDialog pd; 


16 

17 protected void onCreate(Bundle savedInstanceState) ( 
18 super. onCreate(savedInstanceState); 

19 setContentView(R. layout. main); 

20 


21 // 打 开 进 度 对 话 框 的 按钮 
22 Button bok = (Button)this. findViewById(R. id. Button01);// 获 得 Button 对 象 


23 bok. setOnClickListener( // 设 置 OnClickListener 监听 器 
24 new View. OnClickListener()( 

25 (QOverride 

26 public void onClick(View v) ( // 重 写 onClick() 方 法 

27 showDialog(1); // 显 示 进 度 对 话 框 

28 

29 // 步 骤 1: 创建 后 台 任务 的 对 象 ,并 通过 execute( ) 启 动 后 台 线程 ， 

30 // 调 用 doInBackground() 的 代码 ,execute 中 的 参数 类 型 为 参数 1, 这 里 不 需要 传递 任何 内 容 
31 new AddStringTask().execute (); 

32 } 

33 } 

34 ); 

35 } 

36 

37 @Override 

38 protected Dialog onCreateDialog(int id) { // 重 写 onCreateDialog() 方 法 
39 pd = new ProgressDialog(this); // 创 建 进度 对 话 框 

40 pd. setMax(100); // 设 置 最 大 值 

41 pd. setProgressStyle(ProgressDialog. STYLE HORIZONTAL) ; / / Jk F 3i HE 2& 

42 pd. setTitle(" 完 成 进度 ") ; // 设 置 标题 


43 pd. setMessage( "请 稍 等 …"); 
44 pd.setCancelable(false);  // 设 置 进 度 对 话 框 不 能 用 “ 回 退 "按钮 关闭 


46 return pd; // 返 回 生成 Dialog 的 对 象 
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50. // 2: 创建 AsyncTask 子 类 ,参数 1 是 void 的 范式 类 型 ,参数 2 是 Integer 的 范式 类 型 ,参数 3 
// 是 void。 

51 private class AddStringTask extends AsyncTask < Void, Integer, Void» { 

52 // 这 里 加 入 一 个 检测 信息 的 方法 ,打印 当前 在 哪个 线程 执行 的 信息 


53 private void printInfo(String info)( 

54 Log.d("SGMSC", info + " : Tread is " + Thread.currentThread().getName()) ; 
55 ) 

56 


57 // 步 骤 3: 实现 抽象 方法 doInBackground(), 代 码 将 在 后 台 线程 中 执行 , 由 execute( ) 触 发 
58 protected Void/ * 参数 3 * / doInBackground (Void... params/ * $3 1 * /) ( 


59 pd. incrementProgressBy( - pd. getProgress()); // 对 话 框 进度 清 零 
60 for(int i=1;i<=100;i++){ 

61 // 步 骤 2: 通知 U 主线 程 执行 相关 的 操作 (在 onProgressUpdate 中 定义 ) 
62 publishProgress( i/* 参数 2* / ); 

63 printInfo("doInBackgound " + i); 

64 SystenClock. sleep(50) ; 

65 ) 

66 return (null); 

67 ) 

68 


69 // 步 又 3: 定义 收 到 publishProgress() 触 发 后 ,在 UI 主线 程 执行 的 内 容 
70 protected void onProgressUpdate (Integer... values/ * $3 2 + /) ( 


71 printInfo("onProgressUpdate get param" + values[0]); 

72 

73 pd. incrementProgressBy(1); // 进 度 每 次 加 1 

74 if(values[0]>= 100){ // 判 断 是 否 结束 进度 

75 pd. disniss(); // 如 果 进 度 条 走 完 则 关闭 窗口 
76 ) 

77 } 

78 


79 // 步 又 4: 定义 后 台 进 程 执行 完 后 的 处 理 , 本 例 采 用 Toast 
80 protected void onPostExecute (Void result/ * $% 3* / ) ( 


81 printInfo("onPostExecute"); 

82 "loast. makeText (AsyncTask PgDialogActivity.this, "It's Over!", Tbast.LENGTH SHORT). show(); 
83 } 

84 } 

85 } 


@D 第 31 行 ,是 使 用 AsyncTask 的 第 一 步 。 在 onCreate ( ) 方 法 中 调用 自 定义 类 
AddStringTask 的 execute() 方 法 ,创建 后 台 任务 的 对 象 ,并 通过 execute() 启 动 后台 线 程 。 在 
后 面 定 义 子 类 AddStringTask 中 调用 doInBackground() 的 代码 ,execute 中 的 参数 类 型 为 
AsyncTask 的 参数 1, 这 里 不 需要 传递 任何 内 容 。 

© 第 51 一 84 行 定义 了 子 类 AddStringTask。 其 中 ,参数 1 是 Void 的 范式 类 型 ,是 向 后 台 
任务 的 执行 方法 传递 参数 的 类 型 ; 参数 2 是 Integer 的 范式 类 型 ,在 后 台 任 务 执行 过 程 中 , 传 
递 给 主 UI 线程 中 进度 条 的 进度 状态 参数 ; 参数 3 是 Void, 是 后 台 任 务 执行 完 返 回 时 的 参数 
类 型 。 

© 第 54 行 ,创建 一 个 私有 方法 ,该 方法 是 将 操作 信息 info 输出 到 Log 中 ,该 info TE 
方法 doInBackground() 中 提供 。 

QD 第 58 一 67 行 ,实现 抽象 方法 doInBackground O ,代码 将 在 后 台 线 程 中 执行 ,由 execute() 
触发 。 由 于 这 个 例子 并 不 需要 传递 参数 ,所 以 使 用 “Void...” 的 范式 书写 方式 。 在 后 台中 首先 
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执行 将 进度 条 清 零 操作 ,然后 使 用 从 1 到 100 的 循环 ,每 一 步 循环 作 下 列 操作 : 调 上 
publishProgress(i) 以 更 新 主 UI 线程 中 进度 对 话 框 的 状态 ,向 Log 输出 信息 ,系统 休眠 0. 05s。 
© 第 70~77 行 ,定义 收 到 publishProgress() 触 发 后 ,在 UI 主线 程 执行 的 内 容 。 在 本 例 ， 


将 进度 数 i 传 人 values 中 。 其 中 的 参数 为 范式 方式 ,实质 为 Integer 数组 , 即 传 到 values[0 ] 
中 。 第 71 行 向 Log 输出 信息 ; 第 73 一 76 行 , 将 进度 条 的 进度 进 1, 当 进度 条 达到 100 时 关闭 
进度 条 对 话 框 。 

(6 第 80—83 行 重 写 onPostExecute() 方 法 ,定义 后 台 进 程 执行 完 后 的 处 理 , 向 Log 输出 
的 text 部 分 的 信息 为 “onPostExecute”, 并 采用 Toast 向 用 户 界面 显示 提示 消息 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 AsyncTask_PgDialog 项 目 。 
初始 运行 界面 如 图 9-10 所 示 , 单 击 * 显 示 进 度 对 话 框 ?按钮 后 ,随即 出 现 进度 对 话 框 , 且 进 度 条 
的 刻度 逐渐 向 前 递 进 ,直到 100% 结 束 ,如 图 9-11 所 示 。 然 后 ,可 以 在 Eclipse 的 LogCat 窗口 
中 看 到 后 台 操 作 过 程 的 日 志 记录 信息 ,如 图 9-12 所 示 。 


图 9-10 初始 运行 项 目的 界面 图 9-11 单 击 按钮 之 后 调 出 进度 对 话 框 


verbose -| H ILI] 


图 9-12 从 日 志 信 息 中 跟踪 各 部 分 代码 的 执行 过 程 
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6.4 Service 组 件 
e" 


Service 是 Android 系统 提供 的 运行 在 后 台 的 一 种 服务 程序 ,例如 : 播放 音乐 ,后 台数 据 
计算 (如 记录 用 户 的 地 理 信息 位 置 的 改变 ) ,发 出 Notification, EW SD 卡 上 文件 的 变化 ,等 等 。 
它 的 地 位 和 Activity 的 级 别 差不多 ,只 不 过 没有 Activity 使 用 的 频率 高 。 


9.4.1 Service 的 生命 周期 


Service 有 自己 的 生命 周期 , 它 的 生命 周期 方法 比 Activity 要 少 一 些 , 只 有 onCreate()、 
onStart () 和 onDestroy( ) onCreate ( ) 方 法 是 当 Service 第 一 次 被 创建 时 ,由 系统 调用 。 
onStart(Intent intent, int startId) 方 法 是 当 startService() 方 法 启动 Service 时 ,该 方法 被 调 
用 。 从 Android 2. 0 以 后 的 版 本 开始 使 用 onStartCommand 替换 了 之 前 的 onStart, 启 动 时 会 
自动 调用 该 Service 的 onStartCommand() 方 法 。onDestroy() 方 法 是 当 Service 不 再 使 用 时 ， 
由 系统 调用 。 

Service 没有 可 交互 的 用 户 界 面 , 它 不 能 自己 启动 ,必须 要 通过 某 一 个 Activity 或 其 他 的 
Context 对 象 来 启动 。 启 动 一 个 Service 有 两 种 方式 ,一 种 是 通过 调用 startService() 启 动 一 个 
Service, 另 一 种 是 使 用 bindService( ) 方 法 来 绑 定 一 个 存在 的 Service。 不 同 的 启动 方式 对 
Service 生命 周期 的 影响 是 不 一 样 的 。 


1. 通过 startService 启动 


通过 startService 启动 Service, 在 启动 时 会 经 历 onCreate>onStart( 或 onStartCommand) 
过 程 。 注 意 : 如 果 Service 已 经 启动 了 , 当 再 次 启动 Service 时 ,不 会 再 执行 onCreate() 方 法 ， 
而 是 直接 执行 onStart( 或 onStartCommand) 方 法 。 

在 Service 停止 时 直接 进入 onDestroy 过 程 。 如 果 调 用 者 自己 直接 退出 而 没有 调用 
stopService. Service 会 一 直 在 后 台 运 行 , 直 到 下 次 调用 者 再 次 启动 起 来 ,并 调用 stopService 后 
才 会 停止 。 无 论 之 前 调用 过 几 次 startService, 只 要 调用 一 次 stopService, 将 结束 该 Service, 


2. 通过 bindService 启动 


通过 bindService 启动 Service, 在 启动 时 只 会 运行 onCreate, 这 个 时 候 将 调用 者 和 Service 
绑 定 在 一 起 。 

如 果 调 用 者 退出 了 ,Service 也 就 会 调用 onUnbind- onDestroy . 与 调用 者 同时 退出 。 这 
就 是 所 谓 绑 定 的 含义 。 

使 用 这 两 种 方式 启动 Service, 其 生命 周期 可 通过 图 9-13 来 描述 。 


3. Service 的 进程 优先 级 


Service 拥有 较 高 的 优先 级 。 一 般 在 下 列 几 种 情况 下 都 不 会 被 系统 killed fii. 

如 果 Service 正在 调用 onCreate .onStart 或 onDestory 方法 ,那么 用 于 当前 Service 的 进 
程 则 变 为 前 台 进 程 以 避免 被 killed。 

如 果 Service 已 经 被 启动 ,拥有 它 的 进程 仅 次 于 可 见 的 进程 ,而 比 不 可 见 的 进程 重要 ,这 就 
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Component calls Component ca 
startService() bindService() 
onCreate() onCreate() 
1 i 
onStartCommand() onBind() 


Service is running 
Service i " (clients are 
EE Active bound to it) 
Lifetime All clients unbind 
一 一 一 一 ~、 by calling 
The service is stopped] unbindService() 


by itself or a client 
onUnbind() 
t i 
onDestroy() onDestroy() 
Service is Service is 
shut down shut down 
Unbounded Bounded 


图 9-13 ”两 种 启动 Service 的 生命 周期 表现 


意味 着 Service 一 般 不 会 被 killed。 
如 果 客 户 端 已 经 连接 到 Service, 那 么 拥有 它 的 进程 则 拥有 最 高 的 优先 级 ,可 以 认为 该 


Service 是 可 见 的 ,不 会 被 killed. 
如 果 Service 可 以 使 用 startForeground(int，Notification) 方 法 来 将 Service 设置 为 前 台 


状态 ,那么 系统 就 认为 是 对 用 户 可 见 的 ,并 不 会 在 内 存 不 足 时 将 它 killed. 


9.4.2 使 用 Service 


Service 位 于 android. app 包 下 。Service 一 般 由 Activity 启动 ,但 不 依赖 于 Activity, t 
可 以 由 其 他 的 Service 或 者 Broadcast Receiver 启动 。 


1. 创建 Service 子 类 需要 重 写 的 方法 


使 用 Service 进行 编程 ,首先 要 创建 一 个 Service 类 ,创建 方法 比较 简单 ,只 要 定义 一 个 类 
继承 于 Service, 并 且 要 重 写 该 类 中 相应 的 方法 即 可 。 这 些 方法 如 下 。 

(D onBind(Intent intent) 方 法 。 是 必须 实现 的 方法 ,返回 一 个 绑 定 的 接口 给 Service, 

(2) onCreate() 方 法 。 是 当 Service 第 一 次 被 创建 时 ,由 系统 调用 。 

(3) onStart(Intent intent. int startId) 方 法 。 是 当 startService() 方 法 启动 Service 时 ,该 


方法 被 调用 。 
(4) onDestroy() 方 法 。 是 当 Service 不 再 使 用 时 ,由 系统 调用 。 


2. 启动 和 停止 Service 


一 且 定 义 好 一 个 Service, 就 可 以 在 其 他 组 件 中 启动 该 Service 来 使 用 它 了 。 启 动 一 个 
Service 使 用 Context. startService(Intent intent) 方 法 ,这 与 启动 一 个 Activity 非常 相似 ,也 是 
传递 一 个 Intent。 或 使 用 bindService(Intent service, ServiceConnection conn. int flags) 绑 定 
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Service ,其 中 第 一 个 是 Intent; 第 二 个 是 绑 定 Service 的 对 象 ; 第 三 个 参数 是 创建 Service 的 方 
式 ,一 般 指定 为 系统 常量 BIND AUTO_CREATE, 即 绑 定时 自动 创建 。 

1) 启动 Service 

启动 一 个 Service 可 通过 类 名 称 来 显 式 启动 ,例如 已 经 创建 了 一 个 名 为 MyService 的 类 ， 
则 启动 代码 为 : 

Intent myIntent = new Intent(this, MyService.class); 


myIntent. putExtra("TOPPING" , " Margherita"); 
startService(myIntent); 


或 使 用 隐 式 启动 ,代码 为 : 
startService(new Intent(this, MyService. class)); 


2) 停止 Service 
停止 一 个 Service, 可 使 用 stopSelf() 方 法 , 即 由 Service 自己 停止 ,也 可 使 用 stopService() 
方法 。 例 如 代码 : 


stopService(new Intent(this, MyService.class)); 


3) 注册 Service 组 件 
在 应 用 程序 中 使 用 Service, 需 要 在 AndroiManifest. xml 文件 中 显 式 地 注册 二 service 二 标 
签 , 例 如 ， 


< service android:enabled- "true" android:name = ". MyService"/> 


3. Service 的 应 用 


下 面 通过 一 个 简单 的 例子 来 说 明 Service 的 应 用 。 

【案例 9.5】 Service 与 BroadcastReceiver 联合 应 用 : 通过 按钮 启动 Service. Service 运 
ff 1min 后 停止 ,或 通过 单 击 “ 停 止 Service” 按 钮 中 止 Service; 通过 BroadcastReceiver 广播 
Service 运行 的 时 间 。 

【说 明 】 本 例 需 要 设计 两 个 类 ,一 个 是 Activity 类 ,在 其 中 布局 按钮 对 象 和 文本 框 对 象 。 
另 一 个 是 继承 Service 的 子 类 , 重 写 其 相关 的 方法 ,并 且 在 该 服务 子 类 中 定义 Thread FK 
创建 后 台 线 程 。 

案例 中 使 用 BroadcastReceiver 来 广播 Service 运行 的 时 间 。 由 于 BroadcastReceiver 接收 
的 是 应 用 程序 的 广播 信息 ,所 以 使 用 动态 注册 BroadcastReceiver 的 方式 。 

【开发 步骤 及 解析 】 

(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Service BroadcastDemo 的 Android MA., 其 
应 用 程序 名 为 Service_Bdcast, 包 名 为 cn. com. sgmsc. ServiceBroadcast, Activity 组 件 名 为 
Service_BdcastActivity。 

(2) 准备 字符 串 。 编 写 res/values 目录 下 的 strings. xml 文件 ,其 代码 如 下 所 示 。 

1 <?xml version="1.0" encoding = "utf - 8"?> 

2 <resources> 

3 

4 < string name = "app_name"> Service_BroadcastReceiver </string> 
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5 < string name = "hello"> 请 启动 Service «/string» 
6 < string name = "myButton1"> 启 动 Service</string> 
7 < string name = "myButton2"> 停 止 Service</string> 
8 
9 


</resources > 


(3) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 。 其 代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 


3 android:orientation = "vertical" 

4 android:layout width- "fill parent" ^ android:layout height = "fill parent" 
5 android:gravity- "center horizontal"» 

6 < TextView 

7 android: id = "@ + id/myTextView" 

8 android:layout width- "fill parent" android:layout_height = "wrap content" 
9 android: background = " #55elef66" 

10 android: textSize = "20px" 

11 android:gravity = "center_horizontal" 

12 android: text = "@string/hello"/> 

13 

14 < LinearLayout xmlns :android = "http://schemas. android. com/apk/res/android" 
15 android:orientation = "horizontal" 

16 android:layout_width = "fill parent" android:layout_height = "fill parent" 
17 android:gravity = "center_horizontal"> 

18 < Button 

19 android: id = "@ + id/myButton1" 

20 android:layout width- "wrap content" 

21 android:layout height = "wrap content" 

22 android:text = "(à string/myButtonl" 

23 android:layout margin = "10px"/> 

24 « Button 

25 android: id = "(à + id/myButton2" 

26 id:layout width = "wrap content" 

27 layout height = "wrap content" 

28 id:text = "(9 string/nyButton2" 


29 android:layout margin = "10px"/> 
30 «/LinearLayout > 
31 «/LinearLayout » 


(4) JF A GE TR (X03, 3T JF. sre/cn. com. sgmsce. ServiceBroadcast. 包 下 的 


BdcastActivity. java 文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 
package cn. con. sgnsc. ServiceBroadcast; 


1 

2 

3 import android. content. BroadcastReceiver; 
4 import android. content. Context; 

5 import android. content. Intent; 

6 import android. content. IntentFilter; 

7 import android. view. View. OnClickListener; 
8 import android. view. Gravity; 

9 import android. widget. Toast; 

10 //… 省 略 部 分 引入 类 


12 public class Service_BdcastActivity extends Activity { 


13 Button buttonl; // 声 明 按钮 的 引用 
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14 Button button2; // 声 明 按 钮 的 引用 

15 TextView myTextView; 

16 

17 / ** Called when the activity is first created. */ 

18 (2 Override 

19 public void onCreate(Bundle savedInstanceState) { 

20 super. onCreate(savedInstanceState); 

21 setContentView(R. layout. main); 

22 myTextView = (TextView) this. findViewById(R. id. myTextView); 

23 buttonl - (Button) this. findViewById(R. id. myButtonl); 

24 button2 - (Button) this. findViewById(R. id. myButton2); 

25 

26 // 单 击 “ 启 动 Service" fc Hl 

27 buttonl.setOnClickListener(new OnClickListener()( 

28 (QOverride 

29 public void onClick(View v) ( 

30 Intent i = new Intent(Service BdcastActivity.this, MyService. class); 

ar startService(i); 

32 Toast tst = Toast. makeText(Service BdcastActivity. this, 

33 "Service 启动 成 功 "，Toast. LENGTH SHORT); 

34 tst.setGravity(Gravity.CENTER, 0, 0); ”// 将 提示 信息 显示 在 屏幕 的 中 间 位 置 

35 tst. show() ; 

36 ] 

37 H; 

38 // 单 击 “ 停 止 Service” 按 钮 

39 button2. setOnClickListener(new OnClickListener()( 

40 @Override 

41 public void onClick(View v) { 

42 Intent i = new Intent(Service_BdcastActivity. this, MyService. class); 

43 stopService(i); 

44 Toast tst = Toast.makeText(Service BdcastActivity.this, 

45 "Service 停止 成 功 "，Toast. LENGTH SHORT); 

46 tst.setGravity(Gravity.CENTER, 0, 0); 

47 tst. show() ; 

48 i 

49 np; 

50 

51 // 动 态 注册 一 个 BroadcastReceiver 

52 IntentFilter intentFilter = new IntentFilter("cn. com. sgmsc. ServBroad. myThread" ) ; 
// 创 建 过 滤器 

53 MyBroadcasReceiver myBroadcasReceiver = new MyBroadcasReceiver(); 

54 registerReceiver(myBroadcasReceiver, intentFilter); // 注 册 BroadcastReceiver 对 象 

55 ) 

56 

57 // 实 现 MyBroadcasReceiver 

58 public class MyBroadcasReceiver extends BroadcastReceiver{ 

59 @Override 

60 public void onReceive(Context context, Intent intent) { 

61 Bundle myBundle = intent.getExtras(); 

62 int myInt - myBundle.getInt("myThread"); 

63 if(nyInt < 60)( // 后 台 Service 运行 1min 

64 myTextView. setText(" 后 台 Service 运行 了 " + nyInt + "#b"); 

65 }else{ 

66 Intent i = new Intent(Service_BdcastActivity. this, MyService. class); 


67 stopService(i); 
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68 myTextView. setText(" 后 台 Service Æ" + myInt + " 秒 后 停止 运行 ") ; 


(D 第 19 一 55 行 重 写 onCreate() 方 法 。 

© 58 27—37 行 ,定义 了 第 一 个 按钮 的 onClickListener 的 监听 。 第 30 行 创建 了 一 个 
Intent 对 象 i, 第 31 行 启动 一 个 Service, 第 34 行 设置 Toast 对 象 tst 显示 在 屏幕 的 中 间 部 位 。 
注意 ,在 这 里 使 用 了 Gravity, 所 以 要 在 前 面 引入 类 android. view. Gravity, 

© 第 52 一 54 行 ,动态 注册 了 一 个 BroadcastReceiver。 第 52 行 是 创建 一 个 IntentFilter， 
其 中 *cn. com. sgmsc. ServBroad. myThread” 是 程序 员 自 定义 的 ,用 于 Intent 的 过 滤 匹 配 。 

(D 第 58 一 71 行 ,定义 一 个 广播 接收 器 , 重 写 接收 广播 后 的 响应 事件 onReceive。 第 61 行 
创建 一 个 Bundle 对 象 myBundle, 它 获取 传人 的 Intent 中 的 附加 信息 ,这 个 附加 信息 中 有 一 个 
名 为 myThread 的 键 - 值 对 ,其 值 记录 着 服务 启动 的 时 间 。 

© 第 63 一 69 行 , 判 断 当 服务 启动 的 时 间 小 于 60s, 则 对 Text View 中 赋值 并 显示 ; 当 服 务 
启动 时 间 达 到 60s, 即 终止 服务 ,同时 对 TextView 中 赋值 并 显示 。 

(5) 开发 MyService 类 代码 。 在 src/cn. com. sgmsc. ServiceBroadcast 包 下 创建 一 个 代码 
文件 MyService. java, 该 文件 是 定义 一 个 服务 类 MyService, 它 继承 自 Service 类 ,并 且 重 写 其 中 的 
onBindO ,onStart O ffl onDestroy() 方 法 ,并 且 定 义 一 个 MyThread 子 类 。 其 代码 如 下 所 示 。 

1 package cn. con. sgnsc. ServiceBroadcast; 

3 import android. app. Service; 

4 import android. content. Intent; 

5 import android. os. IBinder; 
1 
8 


public class MyService extends Service( 


MyThread nyThread; // 线 程 的 引用 
9 @Override 
10 public IBinder onBind(Intent intent) ( // 重 写 的 onBind( ) 方 法 
11 return null; 
12 ] 
13 (ZOverride 
14 public void onDestroy() ( // 重 写 的 onDestroy() 7; i 
15 myThread.flag = false; // 停 止 线程 运行 
16 super. onDestroy() ; 
17] 
18 (ZOverride 
19 public void onStart(Intent intent, int startId) ( // 重 写 onStart() Jj 3 
20 myThread = new MyThread() ; // 初 始 化 线程 
21 nyThread. start(); // 启 动 线程 
22 super. onStart( intent, startId); 
23 } 
24 


25 // 定 义 线程 类 
26 class MYThread extends Thread{ 


27 boolean flag = true; // 循 环 标志 位 
28 intc = 0; // 其 值 为 发 送 的 消息 
29 (QOverride 


30 public void run() ( 
3t while(flag){ 
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32 Intent i = new Intent("cn. com. sgnsc. ServBroad. myThread" ) ; //&)]£& Intent 
33 i.putExtra("myThread", c); // 放 入 数据 

34 sendBroadcast( i); // 发 送 广播 

35 ctt; 

36 try{ 

37 Thread. sleep(1000); [ERE EEH 
38 }catch(Exception e){ // 捕 获 异 常 

39 e. printStackTrace(); // 打 印 异 常 

40 } 

41 

42 } 

43 ] 

44 ) 


(D 第 19—23 行 重 写 onStart() 方 法 。 在 该 方法 中 启动 自 定义 的 线程 MyThread。 

© 第 26 一 43 行 定义 线程 子 类 MyThread。 在 其 run() 方 法 中 使 用 一 个 while(true) 循 环 ， 
每 隔 1 秒 钟 向 Intent 对 象 传人 一 个 键 - 值 对 ,其 值 为 服务 运行 的 时 间 ; 然后 发 送 广播 。 

(6) 添加 Service 组 件 声明 。 在 AndroidManifest. xml 文件 中 声明 了 一 个 Service 组 件 。 
其 代码 如 下 所 示 。 

1 <?xml version = "1.0" encoding = "utf - 8"?> 


2 <manifest xmlns:android= "http://schemas.android. com/apk/res/android" 
3 package = "cn. com. sgmsc. ServBroad" 


4 android:versionCode = "1" 

5 android:versionName = "1.0" > 

6 

7 < uses - sdk android:minSdkVersion = "10" /> 

8 

9 « application 

10 android: icon = "(Gdrawable/ic launcher" 

11 android: label = "@string/app_name" > 

12 <activity 

13 android: label = "@string/app_name" 

14 android:name = ".Service Broad Demo" > 
15 < intent - filter > 

16 <action android:name = "android. intent. action. MAIN" /> 
i7 

18 < category android:name = "android. intent. category. LAUNCHER" /> 
19 «/ intent - filter? 

20 «/activity» 

21 < service 

22 android:name- ".MyService"» 

23 «/service» 

24 

25 «/application» 

26 


27 </manifest > 


第 21 一 23 行 声 明了 一 个 Service 组 件 , 其 定义 在 类 
MyService 中 。 Seriice BroadcastRecelver 
【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运 = 
行 Service BroadcastDemo 项 目 。 初 始 运 行 界面 如 图 9-14 所 Ce 
示 , 单 击 “ 启 动 Service” 按 钮 后 ,随即 启动 MyService 服务 ,在 
TextView 控件 中 显示 MyService 服务 运行 的 时 间 ,并 且 单 击 图 9-14 初始 运行 界面 


& wi È 06:12 
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按钮 后 在 屏幕 的 中 部 出 现 启动 服务 的 消息 提示 信息 ,如 图 9-15 所 示 。 然 后 , 单 击 “ 停 止 
Service” 按 钮 后 , 即 停止 MyService 服务 ,并 且 在 屏幕 的 中 部 出 现 停止 服务 的 消息 提示 信息 ,如 
图 9-16 所 示 。 如 果 不 单 击 “ 停 止 Service” 按 钮 ,在 该 服务 启动 Imin 后 自动 停止 ,此 时 在 
TextView 控件 中 将 显示 “后 台 Service 运行 了 60 秒 ”。 


à wi W 06:09 
Service BroadcastRecelver m m - 


后 台 Service: 


š wid 06:11 
Service BroadeastReceNer — 
行 了 16 秒 


Service 启 动 成 功 Service 停 止 成 功 


图 9-15 单 击 “ 启 动 Service” 按 钮 后 图 9-16 单 击 “ 停 止 Service” 按 钮 后 


9.5 Android 应 用 开发 步骤 及 应 用 案例 


9.5.1 应 用 开发 的 前 期 准备 


开发 Android 应 用 项 目 ， 
计 。 此 阶段 需要 考虑 的 问题 主 

名 项 目 有 哪些 功能 ? 

名 需要 哪些 用 户 界面 ? 

所 各 界面 之 间 跳 转 的 流程 ? 

名 需要 的 数据 及 其 数据 的 来 源 和 格式 ? 

名 是 否 需要 服务 端的 支持 ? 

名 是 否 需要 本 地 数据 库 的 支持 ? 

名 是 否 需 要 特殊 的 权限 ? 

名 是 否 需 要 后 台 进 程 ? 等 。 

在 程序 员 进 入 代码 编写 之 前 ,都 需要 列 出 这 个 应 用 所 必需 的 功能 ,该 功能 所 需要 的 数据 ， 
数据 的 来 源 及 存储 ; 需要 哪些 展示 界面 ,每 个 界面 上 需要 显示 哪些 元 素 ; 并 列 出 每 个 界面 的 
跳 转 关系 ,需要 哪些 后 台 进 程 ,涉及 哪些 权限 ,等 等 。 对 于 比较 复杂 的 界面 ,最 好 使 用 笔 在 纸 上 
先 画 出 草图 ,精心 设计 布局 。 

另 一 方面 ,一 个 应 用 系统 都 会 有 自己 的 一 套图 标 集 和 色 系 基调 ,在 编码 前 需要 准备 各 界面 
显示 的 图 标 、 图 片 文字 内 容 , 以 及 音频 与 视频 等 素材 ,这 些 都 是 构成 应 用 系统 必 不 可 少 的 资源 。 


# 求 分 析 和 概要 设计 一 定 要 做 到 位 ,认真 做 好 应 用 规划 和 架构 设 
ZW. 
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9.5.2 应 用 开发 步骤 
1. 用 户 界面 设计 


按照 项 目 规划 文档 ,使 用 准备 好 的 图 标 、 图 片 等 资源 ,在 XML 文件 中 描述 出 Android 的 
用 户 界面 。 用 户 界 面 设 计 包 括 : 界面 布局 模式 设计 ,视图 控件 的 大 小 \ 位 置 . 色 彩 搭 配 等 外 观 
设计 ,控件 中 填充 的 数据 适配器 设计 ,菜单 对 话 框 设计 。 另 外 ,还 需要 考虑 其 界面 上 各 个 控件 
需要 响应 的 事件 ,如 单 击 按钮 触发 事件 ,按键 事件 ,触摸 事件 , 单 击 menu 选择 菜单 的 响应 事 


2. 数据 操作 和 存储 


在 描述 完 应 用 程序 的 UI 后 , 接 下 来 需要 仔细 考虑 数据 的 操作 与 存储 策略 。 应 用 项 目的 
数据 来 源 可 以 是 多 方式 的 ,如 SharedPreferences、 文 件 、 数 据 库 、.ContentProvider、 网 络 的 方 
式 。 在 开发 中 ,需要 理 清楚 哪些 数据 需要 存储 ,以 及 选择 哪 种 方式 存储 数据 。 


3. 多 页 面 的 跳 转 实现 


在 应 用 的 UI 和 数据 存储 都 论证 完成 后 ,就 可 以 把 应 用 系统 的 整个 流程 连贯 起 来 了 ,实现 
各 个 界面 直接 的 调用 和 跳 转 流程 。 例 如 ,是 选择 菜单 实现 跳 转 , 还 是 单 击 按钮 实现 跳 转 ,以 及 
监听 事件 的 处 理 。 另 外 ,需要 考虑 程序 的 健壮 性 ,如 果 当 一 些 跳 转 暂时 无 法 连接 时 ,可 以 使 用 
其 他 的 方式 进行 替代 和 弥补 。 

这 个 步骤 用 来 进一步 梳理 应 用 的 界面 。 如 果 整 个 流程 都 可 以 顺利 地 运行 起 来 ,那么 应 用 
项 目的 框架 就 已 经 完成 , 接 下 来 就 是 进一步 实现 其 后 台 处 理 与 完善 细节 工作 。 


4. 增加 Service 
前 面 做 的 工作 都 是 比较 “表面 的 ,主要 实现 的 是 人 -机 交互 以 及 前 台 界 面 跳 转 等 功能 。 在 


实际 应 用 中 还 有 一 个 比较 重要 的 方面 需要 关注 , 那 就 是 论证 应 用 系统 是 否 需要 Service, 如果 
需要 怎样 实现 自己 的 Service。 

5. 完善 应 用 细节 

细节 决定 成 败 。 在 完成 大 部 分 的 功能 后 ,最 后 还 需要 检查 一 些 细节 ,例如 ,如 果 使 用 
Android 提供 的 某 种 特殊 应 用 ,在 AndroidManifest. xml 中 是 否 添加 了 相关 权限 ; 如 果 对 老 版 
本 进行 了 更 新 ,那么 在 AndroidManifest. xml 中 是 否 更 新 versionCode, versionName 的 相应 版 
本 信息 ; 在 模拟 器 上 显示 的 效果 与 真 机 显示 的 效果 的 细小 区 别 , 等 等 。 这 些 细节 技巧 需要 开 
发 者 自己 在 实践 中 不 断 积累 ,逐渐 丰富 自己 的 开发 经 验 ,夯实 开发 功底 。 


6. 应 用 测试 


项 目 程 序 开发 完成 后 ,应 该 接收 系统 的 应 用 测试 。 使 用 模拟 器 和 Eclipse 中 的 DDMS 功 
能 ,可 以 完成 大 部 分 Android 应 用 的 测试 工作 , 且 测 试 出 来 的 效果 与 真 机 上 实现 的 效果 非常 接 
近 。 但 是 有 一 些 操作 ,例如 手机 振动 . 打 电 话 、 拍 照 , 传 感 和 重力 感应 等 功能 还 必须 在 真 机 上 运 
行 才能 测试 出 来 。 所 以 对 Android 的 应 用 测试 最 好 是 在 模拟 器 与 真 机 间 结 合 进行 。 


7. 打包 发 布 
在 应 用 项 目 开 发 完成 ,并 通过 测试 后 ,就 可 以 发 布 了 。 发 布 应 用 需要 对 应 用 项 目 进 行 打 
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包 、 生 成 签名 文件 ,这 部 分 操作 将 在 第 10 章 中 介绍 。 
9.5.3 音乐 播放 器 案例 


下 面 通过 一 个 应 用 案例 ,来 展示 一 个 简单 应 用 的 开发 步骤 。 

【案例 9.6】 设计 一 个 单机 版 的 音乐 播放 器 。 要 求 能 对 指定 的 音乐 进行 播放 暂停 .停止 
控制 ; 显示 歌曲 的 相关 信息 ; 按 下 menu 键 时 ,弹出 “退出 ”选项 菜单 ,退出 时 需要 有 退出 确认 
对 话 框 。 

【说 明 】 需要 定义 两 个 类 ,一 个 是 Activity 类 ,在 其 中 布局 按钮 对 象 和 显示 音乐 相关 信息 
的 若干 控件 对 象 。 另 一 个 是 继承 Service 的 子 类 , 重 写 其 相关 的 方法 ,并 对 音乐 的 播放 、 和 暂停 、 
停止 进行 控制 。 

在 两 个 类 的 onCreate() 方 法 中 各 注册 一 个 广播 接收 器 ,并 都 需要 定义 各 自 的 广播 接收 器 
-类 ,在 Activity 类 中 定义 的 广播 接收 器 子 类 用 于 设置 start 按钮 的 显示 图 片 . 音 乐 播放 状态 
变量 status 的 值 ,并 将 用 户 的 按键 信息 广播 出 去 ; 在 Service 子 类 中 定义 的 广播 接收 器 子 类 用 
于 设置 控制 音乐 的 播放 ,暂停 .停止 等 操作 ,并 将 当前 的 播放 状态 广播 出 去 。 

【开发 步骤 及 解析 】 

CD 准备 素材 。 本 应 用 是 播放 一 首 歌曲 ,需要 准备 一 个 mp3 的 文件 ; 需要 有 与 歌曲 相关 
的 信息 ,如 歌曲 的 词 作 与 谱 曲 .歌词 演唱 者 ; 需要 用 于 控制 音乐 播放 的 按钮 图 片 . 界 面 的 背景 
图 片 等 。 

(2) 界面 设计 。 因 为 本 应 用 只 是 一 个 歌曲 播放 器 ,只 需要 一 个 用 户 界 面 。 在 这 个 界面 中 
涉及 的 信息 元 素 如 下 。 

CD 为 配合 歌曲 内 容 , 设 置 背景 。 

© 在 界面 的 顶端 放置 按钮 和 歌曲 主要 信息 。 

名 左边 并 排放 置 两 按钮 ,“ 播 放 ” 和 “暂停 ”设置 为 一 个 按钮 的 两 种 状态 。 

马 右 边 纵 向 放置 歌曲 名 称 、 歌 唱 人 、 作 词 作曲 人 信息 。 

@ 在 界面 下 部 以 滚动 的 显示 形式 歌词 内 容 。 

@ 需要 设计 一 个 退出 应 用 的 选项 菜单 ,并且 选 择 退 出 时 的 确认 对 话 框 。 

该 音乐 播放 器 运行 时 的 几 种 效果 如 图 9-17 一 图 9-20 所 示 。 


& wi d 1018 & wl È 11:57 
MusicPlayer MusicPlayer 


歌曲 :荷塘 月 色 歌曲 :荷塘 月 色 
> | 这 疯 m 
an 


图 9-17 初始 进入 音乐 播放 器 图 9-18 正在 播放 歌曲 
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图 9-19 按 下 menu 键 显示 退出 菜单 项 


(3) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 MusicPlayer 的 Android 项 目 。 其 应 用 程序 名 
为 MusicPlayer, 包 名 为 cn. com. sgmsc. MusicPlayer, Activity 组 件 名 为 MusicPlayerActivity。 


开发 教程 


(4) 准备 资源 。 
COD 将 背景 图 片 、 按 钮 图 片 复 制 到 res\drawable-mdpi 下 。 


在 res 下 创建 子 目录 raw, 复 制 htys. mp3 文件 到 其 下 。 
设置 需要 使 用 的 颜色 : colors. xml; 
@ 设置 歌曲 歌词 字 


TEH: arrs. xml. 


@ 设置 歌曲 信息 字符 串 : strings. xml, 
(5) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 。 其 代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 
2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:orientation = "vertical" 

android: background = "(9 drawable/musicback" 

android:layout width- "fill parent" 

android:layout height = "fill parent"» 

< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 


android:orientation = "horizontal" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
<! -- 顶端 按钮 与 歌曲 名 布局 -一 > 
< ImageButton 
android: id = "(à + id/start" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src- "(Üdrawable/png2"/» <! -- “播放 ”按钮 -~-> 
< ImageButton 
android: id = "(à + id/stop" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src- "(Üdrawable/pngl"/» <! -- 播 放 “ 停 止 ?按钮 --> 


< LinearLayout xmlns:android = "http://schemas.android. con/apk/res/android" 


android:orientation = "vertical" 


图 9-20 单 击 “ 退 出 ”菜单 项 ,弹出 确认 对 话 框 
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24 android: layout_width= "fill_parent" 

25 android: layout_height = "fill_parent"> 
26 <TextView 

27 android: id= "(9 + id/textViewl" 

28 android: layout_width = "wrap content" 
29 android:layout height = "wrap content" 
30 android:textSize = "20px" 

31 android:textColor = " #ffffff" 

32 android:ellipsize = "marquee" 

33 android:layout weight = "1" 

34 android:marqueeRepeatLimit = "marquee forever" 
35 android: text = "(9 string/myTextViewl"/» 
36 <TextView 

37 android: id= "(9 + id/textView2" 

38 android: textSize = "15px" 

39 android:gravity = "center_vertical" 

40 android:layout weight = "1" 

4l android:layout width- "wrap content" 


42 android:layout height - "wrap content" 
43 android: text = "(9 string/myTextView2" /» 
44 X TextView 

45 android: id= "(9 + id/textView3" 


46 android:textSize = "15px" 


47 android:gravity = "center_vertical" 

48 android:layout weight = "1" 

49 android:layout width- "wrap content" 
50 android:layout height = "wrap content" 
51 android: text = "(9 string/myTextView3" /» 


52 «/LinearLayout > 
53 «/LinearLayout > 
54 < ScrollView 


55 android:layout width- "fill parent" 

56 android:layout height = "fill parent" 

57 android:fillViewport = "true" 

58 > 

59 <! -- 歌词 信息 布局 --> 

60 <ListView 

61 android: id = "@ + id/singtext" 

62 android: layout_width = "fill parent" 
63 android:layout height = "fill parent" 
64 android:ellipsize = "marquee" 

65 /> 


66 </ScrollView> 

67 </LinearLayout > 

(D 第 32 行 , 当 显示 的 文字 内 容 过 长 时 ,使 用 android:ellipsize 属性 设置 显示 方式 。 这 里 ， 
android:ellipsize 一 "marquee" 是 设置 为 走马 灯 方式 ,EditText 不 支持 marquee 方式 。 

© 58 34 £1. f£ ellipsize 指定 为 marquee 的 情况 下 ,android:marqueeRepeatLimit 设置 重 
复 滚 动 的 次 数 , 当 设置 为 marquee_forever 时 表示 无 限 次 。 

@ 第 54 一 66 行 声 明 一 个 ScrollView 控件 ,在 其 中 定义 一 个 ListView 用 于 显示 歌词 。 

(6) 开发 逻辑 代码 。 打 开 src/ cn. com. sgmsc. ServiceBroadcast 包 下 的 Service_BdcastActivity. 
java 文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


1 package cn. com. sgnsc. MusicPlayer; 
2 
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import android. app. AlertDialog; 

import android. app. Dialog; 

import android. content. BroadcastReceiver; 
import android. content.DialogInterface; 
import android. view. Gravity; 

//…… 省略 部 分 引入 类 


public class MusicPlayerActivity extends Activity implements OnClickListener{ 


InageButton start; //“ 播 放 /暂停 ?按钮 
ImageButton stop; // 停 止 ?按钮 
ActivityReceiver activityReceiver; 

int status = 1; // 当 前 的 状态 , 1 没有 声音 播放 ，2 正在 播放 声音 , 3 暂停 


ListView lv; 


@Override 
public void onCreate(Bundle savedInstanceState) { // 重 写 的 onCreate( ) 方 法 
super. onCreate(savedInstanceState); 
setContentView(R. layout. main); // 设 置 当前 的 用 户 界面 
lv = (ListView)findViewById(R. id. singtext); // 获 得 ListView 对 象 的 引用 
Basehdapter myAdapter = new BaseAdapter() ( // 为 ListView 准备 内 容 适配器 
// 定 义 歌词 字符 串 的 数组 


String[] singtxts = getResources() . getStringArray(R. array. singtexts); 


public int getCount() (return singtxts. length; } 
// 歌 词 字符 串 的 数组 的 总 条 目 数 ,这 里 共 23 条 

public Object getItem(int arg0) ( return null; } 
public long getlItemId(int arg0) ( return 0; } 
public View getView(int arg0, View argl, ViewGroup arg2) ( 

// 动 态 生成 每 个 下 拉 项 对 应 的 View, 每 个 下 拉 项 View 由 LinearLayout 

// 中 包含 一 个 TextView 构成 

LinearLayout 11 new LinearLayout(MusicPlayerActivity. this); 

// 初 始 化 LinearLayout 


11. setOrientation(LinearLayout. HORIZONTAL) ; // 设 置 朝向 
11. setPadding(3,0,0,0) ; // 设 置 列表 框 的 四 周 留 白 
TextView tv = new TextView(MusicPlayerActivity.this); // 初 始 化 TextView 
tv. setText(singtxts[arg0]. toString()); // 设 置 内 容 
tv. setTextSize(15); // 设 置 字体 大 小 
tv. setTextColor(MusicPlayerActivity. this. getResources() 

. getColor(R. color. stxt)) ; // 设 置 字体 颜色 
tv. setPadding(3, 0,0,0); // 设 置 文本 控件 的 四 周 留 白 
tv. setGravity(Gravity.LEFT); // 设 置 文字 居 左 对 齐 
11. addView(tv); // 添 加 到 LinearLayout 中 
return 11; 


}; 
lv.setAdapter(myAdapter); 
lv.setVisibility(View. INVISIBLE) ; // 设 置 lv 不 可 见 


start = (ImageButton) this. findViewById(R. id. start); // 得 到 start 的 引用 

stop = (ImageButton) this.findViewById(R.id.stop);  //183] stop 按钮 的 引用 
start. setOnClickListener(this); // 为 按钮 添加 监听 

stop. setOnClickListener(this); // 为 按钮 添加 监听 
activityReceiver = new ActivityReceiver(); // 创 建 BroadcastReceiver 
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IntentFilter filter = new IntentFilter(); // 创 建 IntentFilter 过 滤器 
filter. addAction("cn. com. sgnsc. MusicPlayer.update"); // 添 加 Action 
registerReceiver(activityReceiver, filter); // 注 册 监 听 
Intent intent = new Intent(this, MusicService.class); // 创 建 Intent 
startService( intent); // 启 动 后 台 Service 

) 


/x* 自 定义 的 BroadcastReceiver * / 
public class ActivityReceiver extends BroadcastReceiver{ 

//…… 省 略 一 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
} 


/* 接 口中 的 方法 * / 
(QOverride 
public void onClick(View v) ( 
//…" 省 略 二 : 省 略 了 该 方法 的 代码 段 ,相应 代码 将 在 后 面 给 出 解析 
) 


(QOverride 
protected void onDestroy() ( // 释 放 时 被 调用 
super. onDestroy() ; 
Intent intent = new Intent(this, MusicService.class); // 创 建 Intent 


stopService( intent); // 停 止 后 台 的 Service 
} 
/ * 退出 菜单 及 对 话 框 */ 
@Override 
public boolean onCreateOptionsMenu(Menu menu){ // 弹 出 菜单 
menu. add(0, Menu. FIRST, 0, "退出 ") 
. SsetIcon(android. R. drawable. ic menu delete); // 设 置 图 标 


return true; 


) 


(QOverride 
public boolean onOptionsItemSelected(MenuItem item)( // 选 择 的 菜单 项 
switch(item.getItemId())( // 分 支 判 断 
case Menu. FIRST: 
showDialog(1); // 显 示 对 话 框 
break; 
} 
// 将 来 可 在 此 进行 扩展 
return false; 
} 
@Override 
protected Dialog onCreateDialog( int id){ // 创 建 对 话 框 
switch(id)( // 判 断 
case 1: 
return new AlertDialog. Builder(this) 
.setTitle(" 您 确定 退出 ?") 
. SetPositiveButton( "确定 ",，new android. content. DialogInterface 
.OnClickListener(){ 
@Override 
public void onClick(DialogInterface dialog, int which) { 
System. exit(0); // 直 接 退 出 


} 
n 
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112 . setNegativeButton(" Bii", null) // 取 消 ?按钮 

113 .create() ; 

114 default: 

115 return null; 

116 } 

uo) 

118 

119 } 

(D 第 19 一 62 行 , 重 写 onCreate() 方 法 。 

© 第 24 一 48 行 是 创建 一 个 BaseAdapter 对 象 ,并 将 歌词 内 容 从 字符 串 数组 singtxts 填充 
到 myAdapter 中 ,用 于 为 ListView 准备 内 容 适 配器 。 

© 第 50 行 , 设 置 lv 不 可 见 。setVisibility() 方 法 可 以 设置 控件 的 可 见 与 隐藏 状态 。 

@ 第 56 一 59 行 ,onCreate() 方 法 中 动态 注册 广播 接收 器 activityReceiver, 这 个 接收 器 是 
接收 action 为 “cn. com. sgmsc. MusicPlayer. update” 的 Intent 对 象 。 

© 第 60 一 61 行 ,启动 一 个 服务 ,其 服务 定义 在 子 类 MusicService 中 。 

© 第 76 一 80 行 , 重 写 onDestroy() 方 法 ,在 该 方法 中 停止 服务 。 

D 第 84 一 88 行 ,创建 选项 菜单 。 

第 90 一 98 行 ,定义 单 击 菜单 项 后 的 响应 操作 。 这 里 是 弹出 普通 类 型 的 对 话 框 。 

© 58 100—117 行 ,创建 对 话 框 ,并 定义 单 击 相应 按钮 的 响应 操作 。 

接 下 来 对 省 略 的 部 分 代码 作 解 析 。 

省 略 一 : 这 部 分 省 略 的 代码 是 定义 一 个 内 部 类 ActivityReceiver. 该 类 继承 自 
BroadcastReceiver。 该 子 类 接收 从 服务 子 类 中 传人 的 Intent 对 象 ,因为 对 音乐 的 播放 是 在 服 
务 子 类 中 进行 的 ,这 个 Intent 携带 了 音乐 播放 的 当前 状态 。 有 具体 代码 如 下 。 


1 / * 自 定义 的 BroadcastReceiver * / 

2 public class ActivityReceiver extends BroadcastReceiver( 

3 (QOverride 

4 public void onReceive(Context context, Intent intent) { //3& 8 ff] onReceive() Jj i: 
5 int mupdate = intent.getIntExtra("musicupdate", - 1);// 得 到 intent 中 的 数据 

6 switch(mupdate)( // 分 支 判 断 

y case 1: // 没 有 声音 播放 

8 start. setImageResource(R. drawable. png2) ; // 更 换 图 片 ,此 时 为 播放 图 片 
9 status = 1; // 设 置 当前 状态 

10 break; 

1l case 2: // 正 在 播放 声音 

12 start. setImageResource(R. drawable. png3) ; // 更 换 图 片 , 此 时 为 暂停 图 片 
13 status = 2; // 设 置 当 前 状态 

14 break; 

15 case 3: // 暂 停 中 

16 start. setImageResource(R. drawable. png2) ; / [3835 E] Fr , 此 时 为 播放 图 片 
17 status = 3; // 设 置 当前 状态 

18 break; 

19 } 

20 } 

21. } 


CD 第 5 行 ,从 广播 的 Intent 中 获取 键 - 值 对 中 键 名 为 musicupdate 的 值 ,该 值 记录 的 是 播 
放声 音 的 当前 状态 。 播 放 状态 有 三 种 : 值 为 1 时 表示 没有 声音 播放 状态 , 值 为 2 时 表示 正在 
播放 声音 状态 , 值 为 3 时 表示 暂停 状态 。 
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© 第 6 一 19 行 ,根据 当前 的 状态 设置 start 按钮 的 图 片 和 status 变量 的 值 。 
省 略 二 : 这 部 分 省 略 代 码 是 本 类 接口 OnClickListener 中 的 回调 方法 。 在 该 onClick() 方 
法 中 ,创建 一 个 Intent 对 象 ,并 根据 哪个 按钮 被 单 击发 送 不 同 的 广播 信息 。 


/* 接口 中 的 方法 * / 
@Override 
public void onClick(View v) { 
Intent intent = new Intent("cn. com. sgmsc. MusicPlayer. control"); // 创 建 Intent 
switch(v. getId()){ // 分 支 判断 
case R. id. start: // 单 击 “ 播 放 / 暂 停 ” 按 钮 
lv.setVisibility(View. VISIBLE) ; 
intent.putExtra(" ACTION", 1); // 存 放 数据 
sendBroadcast( intent); // 发 送 广播 
break; 
case R. id. stop: // 单 击 “ 停 止 " 按 钮 
intent. putExtra( "ACTION", 2); // 存 放 数 据 
sendBroadcast( intent) ; // 发 送 广播 
break; 
} 
} 


(D 第 4 行 创建 一 个 Intent 对 象 ,该 Intent 的 action 内 容 是 “cn. com. sgmsc. MusicPlayer. 
control", 

© 第 6 一 10 行 定义 , 当 start 按钮 被 单 击 时 ,使 用 主 界面 的 lv 变 为 可 见 状 态 ,给 ACTION 
键 - 值 对 赋值 1 ,将 该 Intent 广播 出 去 。 

图 第 11 一 15 行 定 义 , 当 stop 按钮 被 单 击 时 ,给 ACTION 键 - 值 对 赋值 2, 将 该 Intent 广 
播 出 去 。 

CD 开发 MusicService 类 代码 。 在 src/cn. com. sgmsc. MusicPlayer 包 下 创建 一 个 代码 
文件 MusicService. java ,该 文件 是 定义 一 个 服务 类 MusicService, 它 继承 自 Service 类 ,并 且 重 
写 其 中 的 onBind() ,onCreateO ffl onDestroy() 方 法 ,并 且 定 义 一 个 ServiceReceiver 广播 接收 
器 子 类 。 其 代码 如 下 所 示 。 


package cn. com. sgnsc. MusicPlayer; 


import android. app. Service; 

import android. content. BroadcastReceiver; 
import android. media. MediaPlayer; 

import android. os. IBinder; 

//…… 省 略 了 部 分 引入 类 


public class MusicService extends Service( 
MediaPlayer mp; 


ServiceReceiver serviceReceiver; 


intstatus - 1; // 当 前 的 状态 , 1 没有 声音 播放 ,2 正在 播放 声音 , 3 暂停 
@Override 
public IBinder onBind(Intent intent) { // 重 写 的 onBind( ) 方 法 


return null; 

) 

@Override 

public void onCreate() { // 重 写 的 onCreate() 方 法 
status = 1; 
serviceReceiver - new ServiceReceiver(); // 创 建 BroadcastReceiver 
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22 IntentFilter filter = new IntentFilter(); // 创 建 过 滤器 

23 filter.addAction("cn. com. sgnsc. MusicPlayer.control"); // 添 加 Action 

24 registerReceiver(serviceReceiver, filter); // 注 册 BroadcastReceiver 
25 super. onCreate( ); 

26 } 

27 (8Override 

28 public void onDestroy() ( // 重 写 的 onDestroy() r1 
29 unregisterReceiver(serviceReceiver); // 取 消 注册 

30 super. onDestroy( ); 

31] 

32 

33 public class ServiceReceiver extends BroadcastReceiver( // B 3E X. BroadcastReceiver 


34 (2 Override 
35 public void onReceive(Context context, Intent intent) { // 重 写 的 响应 方法 


36 int action = intent.getIntExtra("ACTION", - 1); 

37 switch(action)( 

38 case 1: // 播 放 或 暂停 声音 

39 if(status == 1)( // 当 前 没有 声音 播放 
40 mp = MediaPlayer.create(context, R.raw.htys); 

4l status - 2; 

42 Intent sendIntent - new Intent("cn. com. sgnsc. MusicPlayer. update") ; 
43 sendIntent. putExtra("musicupdate", 2); 

44 sendBroadcast ( sendIntent) ; 

45 mp. start(); 

46 ) 

47 else if(status -- 2)( // 正 在 播放 声音 

48 np. pause( ); // 停 止 

49 status = 3; // 改 变 状态 

50 Intent sendIntent = new Intent("cn. com. sgmsc. MusicPlayer. update") ; 
51 sendIntent. putExtra("musicupdate", 3); // 存 放 数据 

52 sendBroadcast( sendIntent); // 发 送 广播 

53 } 

54 else if(status == 3){ // 暂 停 中 

55 np.start(); // 播 放声 音 

56 status = 2; // 改 变 状态 

57 Intent sendIntent = new Intent("cn. com. sgnsc. MusicPlayer. update"); 
58 sendIntent. putExtra("musicupdate", 2); // 存 放 数 据 

59 sendBroadcast(sendIntent); // 发 送 广播 

60 } 

61 break; 

62 case 2: // 停 止 声音 

63 if(status == 2 || status == 3){ // 播 放 中 或 暂停 中 

64 mp. stop(); // 停 止 播放 

65 status = 1; // 改 变 状态 

66 Intent sendIntent = new Intent("cn. com. sgnsc. MusicPlayer. update"); 
67 sendIntent. putExtra("musicupdate", 1); // 存 放 数据 

68 sendBroadcast(sendIntent); // 发 送 广播 

69 } 

70 } 

} 

72. ) 
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(D 第 19 一 26 行 重 写 onCreate() 方 法 。 在 该 方法 中 设置 初始 的 播放 状态 为 无 声音 的 ; 注 
册 一 个 广播 接收 器 serviceReceiver ,接收 action 为 “cn. com. sgmsc. MusicPlayer. control" fff 
Intent 对 象 。 

© 第 28 一 31 行 重 写 onDestroy() 方 法 。 在 该 方法 中 注销 广播 接收 器 serviceReceiver。 
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( 第 33 一 72 行 定 义 了 一 个 ServiceReceiver 广播 接收 器 子 类 。 重 写 了 onReceiver() 方 法 
对 action 为 “cn. com. sgmsc. MusicPlayer. control” 的 Intent 进入 处 理 。 

@ 58 38—61 行 是 当 ACTION 值 为 1, 即 start 按钮 被 单 击 时 的 处 理 。 此 时 要 根据 status 
中 的 状态 值 分 别处 理 。 第 39 一 46 行 是 定义 当前 处 于 没有 播放 任何 音乐 状态 处 理 操 作 。 其 处 
理 代码 首先 要 实例 化 一 个 MediaPlayer 对 象 mp ,定义 其 音乐 来 源 于 raw 目录 下 的 htys. mp3 
文件 ; 将 status 值 设 为 2; 创建 一 个 Intent 对 象 sendIntent, 其 action 为 “cn. com. sgmsc. 
MusicPlayer. update"; 向 键 - 值 对 的 musicupdate 中 传人 值 2, 即 将 当前 的 音乐 播放 状态 传 入 
该 键 - 值 对 中 ; 最 后 将 sendIntent 广播 出 去 。 接 下 来 的 第 47 一 53 行 ,第 54 一 60 行 ,都 是 对 
start 按钮 的 不 同 状 态 进 行 处 理 。 

© 第 62 一 70 行 是 当 ACTION 值 为 2, 即 stop 按钮 被 单 击 时 的 处 理 代码 。 

(8) 添加 Service 组 件 声明 。 在 AndroidManifest. xml 文件 中 要 声明 一 个 Service 组 件 。 
由 于 两 个 BroadcastReceiver 都 是 在 程序 中 动态 注册 的 ,所 以 不 需要 在 AndroidManifest. xml 
文件 中 注册 了 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 MusicPlayer 项 目 。 运 行 结果 
符合 设计 要 求 。 

问 一 下 : 

么 案例 9. 5 在 Service 子 类 只 重 写 了 onStart() 方 法 ,而 案例 9. 6 在 Service 子 类 中 只 

重 写 了 onCreate() 方 法 ? 

案例 9.5 和 案例 9. 6 都 是 关于 Service 的 应 用 

在 案例 9. 5 中 ,用 户 可 以 反复 地 对 指定 的 Service 进行 启动 和 停止 。 因 此 在 自 定 义 的 Service 
子 类 中 ,需要 重 写 onStart() 方 法 ,以 便 每 次 启动 该 Service 时 ,可 以 做 些 初始 化 的 操作 。 

在 案例 9. 6 中 ,用 户 只 是 通过 启动 一 次 服务 ,就 可 对 所 播放 的 音乐 进行 反复 的 播放 、 暂 停 
与 停止 操作 ,退出 服务 后 程序 便 结 束 了 。 因 此 在 自 定义 的 Service 子 类 中 ,需要 重 写 onCreate() 方 
法 ,只 在 Service 子 类 首次 创建 时 运行 onCreate() 方 法 ,执行 与 创建 该 Service 有 关 的 操作 。 


本 章 介绍 了 Android 应 用 项 目 编程 的 几 种 后 台 处 理 技术 。 消 息 提示 Toast 和 Notification 给 
出 的 消息 提示 方式 不 同 , 在 编程 中 要 根据 不 同 的 应 a BroadcastReceiver 传递 的 广 
播 要 与 其 注册 时 Intent 的 action 内 容 相 匹配 。 后 台 线 程 与 UI 线程 的 信息 交互 可 使 用 
Handler 和 AsyncTask 两 种 方式 ,使 用 中 要 掌握 bb 息 传递 机 制 、 正 确 的 编程 步骤 ,以 及 
相关 规则 。Service 是 Android 中 的 重要 组 件 之 一 ,在 应 用 上 其 使 用 频率 仅 次 于 Activity, 4 
Service 提供 的 后 台 服 务 需 要 与 用 户 进行 交互 时 ,这 时 通常 借助 于 BroadcastReceiver 来 与 前 
台 的 Activity 交换 信息 。 熟 练 掌握 这 些 后 台 编程 技术 ,就 为 深层 次 的 应 用 开发 商定 了 不 可 或 
缺 的 基础 。 最 后 ,简要 地 介绍 了 开发 一 个 应 用 项 目 应 该 遵从 的 开发 步骤。 

随 着 无 线 互联 网 技术 的 发 展 ,手机 应 用 只 有 与 网 络 相 联 ,才能 延展 其 生命 力 。 第 10 章 中 
将 学 习 Android 的 网 络 应 用 开发 。 


E3 


为 自己 的 微 博 相册 浏览 模块 添加 一 个 可 控制 的 背景 音乐 播放 功能 。 
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Google 公司 以 其 强大 的 互联 网 搜索 引擎 业务 ,在 互联 网 领域 独占 鳌头 。Android 是 由 
Google 公司 推出 的 一 款 手机 操作 系统 ,其 网 络 功 能 自然 会 非常 强大 。 随 着 无 线 互联 网 的 迅猛 
发 展 , 人 们 可 以 不 受 时 间 空间 的 限制 ,随时 随地 地 进行 数据 交换 、 网 页 浏览 .事务 处 理 , 例 如 手 
机 银行 .手机 炒股 、 手 机 地 图 、 手 机 微 博 、 手 机 QQ 聊天 、 手 机 购物 、 手 机 收发 邮件 等 。 

本 章 主 要 介绍 Android 平台 下 进行 网 络 编程 和 网 络 应 用 的 相关 知识 ,内 容 包括 网 络 的 通 
信 方 式 ,获取 网 络 中 数据 ,浏览 网 页 以 及 地 理 位 置 定 位 等 。 


10.1 使 用 Socket 进行 通信 


在 Android 平台 下 进行 Socket 开发 和 在 Java 平台 下 的 开发 比较 类 似 。Java 在 包 java. 
net 中 提供 了 两 个 类 Socket 和 ServerSocket ,分 别 用 来 表示 双向 连接 的 客户 端 和 服务 端 。 使 
用 Socket, ServerSocket 编程 方式 可 以 说 是 比较 底层 的 ,其 他 的 高 级 协议 (如 HTTP) 都 是 建立 
在 此 基础 之 上 的 ,而 且 Socket 编程 是 跨 平台 的 编程 ,可 以 在 异 构 语 言 之 间 进 行 通信 。 所 以 掌 
握 Socket 网 络 编程 是 基础 。 


10.1.1 Socket 编程 模型 


Socket 通常 称 为 “ 套 接 字 ”, 应 用 程序 通常 通过 “和 套 接 字 ” 向 网 络 发 送 请 求 或 者 应 答 网 络 请 
求 。 使 用 Socket 模型 的 运作 机 理 是 : 首先 创建 一 个 SocketServer 的 类 作为 服务 端 ,该 服务 端 
实现 了 多 线程 机 制 ,可 以 在 特定 端口 处 监听 多 个 客户 请 求 , 一 旦 有 客户 请 求 ,Server 总 是 会 创 
建 一 个 服务 来 服务 新 来 的 客户 ,而 自己 继续 监听 。 当 客户 端 与 服务 器 端 建立 连接 后 ,在 客户 端 
和 服务 器 端 都 会 建立 用 于 通信 的 Socket 实例 , 接 下 来 就 是 由 各 个 Socket 分 别 打 开 各 自 的 输 
入 ,输出 流 , 完 成 所 需 的 会 话 。 

客户 端 和 服务 器 端 通过 套 接 字 进行 通信 ,主要 的 Socket 类 型 有 流 套 接 字 (Stream Socket) 
和 数据 报 套 接 字 (Datagram Socket), 可 以 使 用 TCP 或 者 UDP, 不 同 的 底层 协议 有 不 同 的 
Socket。TCP 使 用 流 套 接 字 进行 通信 ,UDP 使 用 数据 报 套 接 字 进 行 通信 。 本 节 只 介绍 在 
TCP/IP 协议 族 下 的 Socket, 

在 Socket 编程 中 ,Socket 类 用 来 建立 客户 端 程序 ,ServerSocket 类 用 于 建立 服务 器 端 程 
序 。 首 先 来 介绍 ServerSocket 类 编程 。 


1. ServerSocket 类 


ServerSocket 类 是 实现 一 个 服务 器 端的 Socket ,利用 这 个 类 可 以 监听 来 自 网 络 的 请 求 。 
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创建 ServerSocket 的 方法 为 : 
ServerSocket(int localPort [, int queueLimit]) 


其 中 ,参数 localPort 为 端口 号 ,其 有 效 范围 是 0 一 65 535。 在 创建 时 必须 指定 一 个 端口 
号 ,以 便 客户 端 能 够 向 该 端口 号 发 送 连接 请 求 。 参 数 queueLimit 为 可 选项 ,用 来 显 式 地 设置 
连接 请 求 队列 的 长 度 , 它 将 覆盖 操作 系统 限定 的 队列 的 最 大 长 度 。 

常用 的 操作 ServerSocket 的 方法 如 下 所 述 。 

1) accept() 方 法 

accept() 方 法 为 下 一 个 传人 的 连接 请 求 创 建 Socket 实例 ,并 将 已 成 功 连接 的 Socket 实例 
返回 给 服务 器 套 接 字 ,如 果 没 有 连接 请 求 ,accept() 方 法 将 阻塞 并 等 待 。 这 里 , “阻塞 ”是 一 个 
术语 , 它 使 程序 运行 暂时 “停留 ”在 这 个 地 方 ,直到 一 个 会 话 产 生 , 然 后 程序 继续 。 通 常 “ 阻 塞 ” 
是 由 循环 产生 的 。accept() 是 一 种 阻塞 性 方法 ,所 谓 阻塞 性 方法 就 是 说 该 方法 被 调用 后 将 等 
待 客户 的 请 求 , 直 到 有 一 个 客户 启动 并 请 求 连接 到 相同 的 端口 ,然后 accept 〇 返回 一 个 对 应 于 
客户 的 Socket。 

2) close() 方 法 

close() 方 法 用 于 关闭 套 接 字 。ServerSocket 的 close() 方 法 使 服务 器 释放 占用 的 端口 ,并 
且 断 开 与 所 有 客户 的 连接 。 当 一 个 服务 器 程序 运行 结束 时 ,即使 没有 执行 ServerSocket 的 
close() 方 法 ,操作 系统 也 会 释放 这 个 服务 器 占用 的 端口 。 因 此 ,服务 器 程序 并 不 一 定 要 在 结 
束 之 前 执行 close() 方 法 。 在 某 些 情况 下 ,如 果 和 希望 及 时 释放 服务 器 的 端口 ,以 便 让 其 他 程序 
能 占用 该 端口 , 则 可 以 显 式 地 调用 ServerSocket 的 close() 方 法 。 

3) isClosed() 方 法 

isClosed() 方 法 用 于 判断 ServerSocket 是 否 关闭 。 只 有 执行 了 ServerSocket 的 close( ) 方 
法 ,isClosed() 方 法 才 返 回 true; 否则 ,即使 ServerSocket 还 没有 和 特定 端口 绑 定 ,isClosed() 
方法 也 会 返回 false。 

4) getInetAddress() 方 法 

getInetAddress() 方 法 返回 一 个 IP 地 址 , 它 使 得 ServerSocket 获得 服务 器 绑 定 的 IP 地址 。 

5) getLocalPort() 方 法 

getLocalPort() 方 法 返回 一 个 int 值 , 它 使 得 ServerSocket 获得 服务 器 绑 定 的 端口 号 。 在 
构造 ServerSocket 时 ,如 果 把 端口 设 为 0, 那么 将 由 操作 系统 为 服务 器 分 配 一 个 端口 ( 称 为 匿 
名 端口 ) ,程序 只 要 调用 getLocalPort() 方 法 就 能 获知 这 个 端口 号 。 


2. Socket 类 


使 用 Socket 来 与 一 个 服务 器 通信 ,必须 先 在 客户 端 创建 一 个 Socket, 并 在 Socket 对 象 中 
指定 服务 器 的 IP 地 址 和 端口 ,这 也 是 使 用 Socket 通信 的 第 一 步 。 创 建 Socket 的 方法 为 : 


Socket(inetAddress remoteAddress , int remotePort) 


其 中 ,参数 remoteAddress 是 远程 服务 器 的 IP 地 址 ,这 里 ,IP 地 址 可 以 由 一 个 字符 串 来 定 
义 ,这 个 字符 串 可 以 是 数字 型 的 地 址 (如 192. 168. 1. D ,也 可 以 是 主机 名 (如 example. com) 。 参 
数 remotePort 是 远程 服务 器 的 端口 号 。 

利用 Socket 的 构造 函数 ,可 以 创建 一 个 TCP 套 接 字 后 , 先 连接 到 指定 的 远程 地 址 和 端口 
号 上 。 由 于 使 用 Socket 编程 是 一 种 网 络 通信 应 用 ,所 以 要 在 AndroidManifest. xml 文件 中 的 
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二 manifest 记 标签 内 添加 网 络 访问 权限 ,添加 该 权限 的 代码 为 : 
<uses - permission android:name = "android. permission. INTERNET" /> 


在 编程 中 ,操作 Socket 常用 的 方法 如 下 。 

(D getInputStream() 方 法 ,功能 是 获得 网 络 连接 输入 ,同时 返回 一 个 IutputStream 对 象 
实例 。 

(2) getOutputStream ( ) 方 法 ,功能 是 使 得 连接 的 另 一 端 得 到 输入 ,同时 返回 一 个 
OutputStream 对 象 实例 。 

G) close() 方 法 ,功能 是 关闭 Socket 对 象 。 

接 下 来 介绍 Socket 的 通信 过 程 ,充分 理解 其 通信 过 程 , 有 助 于 Socket 开发 。 


3. Socket 通信 过 程 


Socket 通信 过 程 主要 分 为 服务 器 端 编程 和 客户 端 编程 。 

服务 器 端 ,首先 使 用 ServerSocket 监听 指定 的 端口 ,等 待 客户 连接 请 求 ,客户 连接 后 ,会 
话 产 生 ; 在 完成 会 话 后 ,关闭 连接 。 

客户 端 ,使 用 Socket 对 网 络 上 某 一 个 服务 器 的 某 一 个 端口 发 出 连接 请 求 , 一 旦 连接 成 功 ， 
打开 会 话 ; 会 话 完成 后 ,关闭 Socket, 

如 果 是 多 客户 同时 连接 服务 器 ,服务 器 中 主 程序 监听 一 端口 ,等待 客户 接 入 ; 同时 构造 一 
个 线程 类 ,准备 接管 会 话 。 当 一 个 Socket 会 话 产生 后 ,将 这 个 会 话 交 给 线程 处 理 , 然 后 主 程序 
继续 监听 。 

在 Android Socket 的 通信 中 ,中 间 的 管道 连接 是 通过 InputStream/OutputStream 流 实现 
的 ,一 旦 管道 建立 起 来 就 可 以 进行 通信 ,如 果 对 同一 个 Socket 创建 重复 管道 会 异常 。 关 闭 管 
道 的 同时 意味 着 关闭 Socket。 在 开发 Socket 程序 时 一 定 要 注意 通信 的 顺序 。 服 务 器 端 首先 
得 到 输入 流 , 然 后 将 输入 流 信息 输 出 到 其 各 个 客户 端 ; 客户 端 是 首先 建立 连接 ,然后 写 人 输出 
流 ,最 后 再 获得 输入 流 。 如 果 开 发 的 顺序 不 对 则 会 产生 EOFException 的 异常 。 为 此 ,给 出 使 
用 Socket 的 开发 步骤 。 

根据 Socket 的 通信 过 程 ,得 出 其 编程 步骤 。 下 面 给 出 阐述 。 


4. Socket 开发 步骤 


1) 服务 器 端 编程 步骤 

CD 创建 服务 器 端 套 接 字 并 绑 定 到 一 个 端口 上 (因为 0 一 1023 是 系统 预 留 的 号 码 ,端口 号 
最 好 选用 大 于 1024 的 数字 ) 。 

(2) 套 接 字 设 置 监听 模式 等 待 连接 请 求 。 

(3) 接受 连接 请 求 后 进行 通信 。 

(4) 返回 ,等 待 下 一 个 连接 请 求 。 

2) 客户 端 编程 步骤 

CD 创建 客户 端 套 接 字 (指定 服务 器 端 IP 地 址 与 端口 号 ) 。 

(2) 连接 (Android 创建 Socket 时 会 自动 连接 ) 。 

(3) 与 服务 器 端 进行 通信 。 

(4) 关闭 套 接 字 。 
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最 后 别 忘 了 ,要 在 AndroidManifest. xml 文件 中 的 二 manifest 二 标签 内 添加 可 访问 网 络 权 


限 ,代码 为 “一 uses-permission android:name 一 "android. permission. INTERNET"/77", 
10.1.2 使 用 Socket 应 用 实例 


【案例 10.1]. 使 用 Socket 进行 服务 器 与 客户 端 之 间 的 通信 : 当 客 户 连 接 服务 器 成 功 后 
服务 器 向 控制 台 传 送 一 字符 串 信 息 ; 服务 器 端 向 客户 端 传送 系统 当前 日 期 。 

DAJ 本 例 需 要 开发 服务 器 端 程序 和 客户 端 程序 。 服 务 器 端的 程序 是 Java Application, 
客户 端 程序 是 Android Application。 

本 例 的 服务 器 端 和 客户 端 都 创建 在 本 机 上 ,因此 服务 器 的 IP 地 址 是 本 机 的 IP 地 址 。 在 
开发 前 应 该 先知 道 本 机 的 IP 地 址 。 获 取 本 机 的 IP 地 址 可 使 用 如 下 方法 : 在 命令 行 状态 , 输 
入 “ipconfig”, 即 可 看 到 本 机 的 TP 地 址 信息 ,如 图 10-1 所 示 。 


图 10-1 在 命令 行 状 态 下 查看 本 机 的 IP 地 址 


注意 ,如 果 计算 机 网 络 连接 属性 中 设置 本 地 连接 是 “自动 获得 IP 地 址 ?方式 , 则 本 机 的 IP 
地 址 是 不 固定 的 ,有 时 会 有 变化 。 所 以 在 开发 前 最 好 查看 一 下 本 机 的 IP 地 址 。 有 时 候 ,测试 
本 案例 程序 时 不 能 连接 到 服务 器 ,有 可 能 是 IP 地 址 不 对 引起 的 ,可 考虑 检查 程序 中 指定 的 IP 
地 址 是 否 与 本 机 的 IP 地 址 一 致 。 

【开发 步骤 及 解析 】 

CD 开发 服务 器 端 程序 。 

CD 创建 Java Application 项 目 。 在 Eclipse 中 ,选择 菜单 New 一 Java Project, 创 建 一 个 名 
为 Socket_Server 的 Java 应 用 项 目 。 

@ 创建 包 名 。 展 开 至 Socket Server 的 src 目录 ,选择 菜单 New 一 Package, 输 入 包 名 为 
cn. com. sgmsc. Socket. 

© 创建 Java 代码 。 展 开 至 Socket Server/src 目录 的 包 cn. com. sgmsc. Socket. 3€ FEK 
单 New 一 File, 输 入 文件 名 为 MyServer. java, 并 编辑 之 ,其 代码 如 下 所 示 。 


package cn. com. sgnsc. Socket ; 


import java. io. DataOutputStream; // 引 入 相关 类 
import java. net. ServerSocket; // 引 入 相关 类 
import java. net. Socket; // 引 入 相关 类 


un wm 
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6 import java. util. Date; // 引 入 相关 类 
7 

8 public class MyServer( 

9 public static void main(String args[ ]) ( 


10 try{ 

11 ServerSocket myss = new ServerSocket(8000); 
12 System. out. println("Listening..."); 

13 while(true){ 

14 Socket ssocket = myss.accept(); 

15 System. out. println("Client Connected..."); 
16 DataO0utputStream dout = new DataOutputStream(ssocket.getOutputStream()); 
17 Date dt = new Date(); 

18 dout. writeUTF (dt. toLocalString()); 

19 dout. close(); 

20 ssocket. close() ; 

21 j 

22 } 

23 catch( Exception e) { 

24 e. printStackTrace(); 

235 } 

26 } 

29] 


578 11 行 创 建 服 务 器 端 套 接 字 myss, 并 绑 定 到 一 个 端口 8000 上 。 这 时 ,服务 器 Socket 
就 可 以 监听 来 自 网 络 端口 8000 的 请 求 。 

名 第 12 行 ,使 用 System. out. println() 方 法 向 系统 的 控制 台 发 出 字符 串 “Listening...”， 
表示 服务 器 已 启动 ,正在 监听 客户 端 。 

aR 13—21 行 是 一 个 无 限 循环 ,在 这 个 循环 中 定义 了 一 系列 的 服务 器 接 到 客户 请 求 的 处 
理 , 直 到 服务 器 程序 退出 。 

c8 14 行 通过 服务 器 Socket 的 accept() 方 法 创建 一 个 Socket 实例 ,如 果 此 时 有 客户 端 
已 成 功 连接 到 则 创建 Socket 实例 完成 ,如 果 没 有 客户 端的 连接 请 求 ,accept() 方 法 将 阻 
塞 并 等 待 。 当 等 待 到 客户 端的 连接 请 求 后 则 创建 Socket 实例 ssocket, 并 向 控制 台 发 
出 客户 端 已 连接 信息 (第 15 行 定义 ) 。 

局 第 16 行 创 建 一 个 ssocket 的 输出 流 对 象 dout, 该 对 象 用 于 向 客户 端 传送 信息 ; 第 18 
行 ,利用 writeUTF() 方 法 将 系统 当前 日 期 的 字符 串 值 写 和 到 dout 中 。 

58 19,20 行 , 当 向 客户 端 传 出 信息 后 即刻 释放 输出 流 dout 和 Socket 对 象 ssocket。 然 
后 返回 到 循环 头等 待 下 一 个 连接 请 求 。 

(2) 开发 客户 端 编程 。 

(D 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Socket. Client 的 Android 项 目 。 其 应 用 程序 

名 为 Socket_Client, 包 名 为 cn. com. sgmsc. Socket. Activity 组 件 名 为 ClientActivity。 

@ 准备 字符 串 资 源 。 编 写 res/values 目录 下 的 strings. xml 文件 。 

© 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version="1.0" encoding = "utf - 8"?> 

2 <LinearLayout xmlns:android= "http://schemas.android. con/apk/res/android" 

3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

: mm 


8 

9 

10 
11 
12 
B 
14 


android:id- "(2 + id/et" 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = "(9 string/et" 


android:editable = "false" 


android:cursorVisible = "false" 


/> 


15 </LinearLayout > 


CD 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Socket 包 下 的 ClientActivity. java 文件 ,并 
编辑 之 。 代 码 如 下 所 示 。 


32 
33 


package cn. con. sgnsc. Socket; 


import java. io. DataInputStream; 
import java. net. Socket; 

import android. app. Activity; 
import android. os. Bundle; 
import android. widget. EditText; 
//import java. net. InetAddress; 


public class ClientActivity extends Activity { 


@Override 


public void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState) ; 
setContentView(R. layout. main); 


connectToServer( ); 


} 


public void connectToServer( ) { 


第 10 章 ”网 络 与 位 置地 图 


// 设 置 当 前 屏幕 
// 连 接 服务 端 


// 方 法 : 连接 服务 器 端 代码 


try{ 
EditText myet = (EditText)findViewById(R. id. et); // 获 得 EditText 对 象 
Socket mysocket = new Socket("192.168.1.102", 8000);  ”// 创 建 Socket 对 象 
// InetAddress serverAddr = InetAddress.getByName("192.168.1.102"); 
// 获 取 本 机 的 IP 地 址 
// Socket mysocket = new Socket(serverAddr, 8000); // 创 建 Socket 对 象 
DataInputStream dinstream = new DataInputStream(mysocket. getInputStream( ) ) ; 
// 获 得 DataInputStream 对 象 
String servermsg = dinstream. readUTF(); // 读 取 服 务 端 发 来 的 消息 
myet. setText(servermsg); // 设 置 EditText 对 象 


mysocket. close(); 
) 
catch(Exception e)( 
e. printStackTrace(); 
) 
) 
) 


// 关 闭 Socket 对 象 
// 捕 获 并 打印 异常 


名 在 onCreate() 方 法 内 需要 进行 连接 服务 器 端的 编程 ,为 了 突出 连接 步骤 , 特 将 相关 代码 


写 在 一 个 自 定义 的 connectToServer() 方 法 中 。 


8 21 行 创建 客户 端 套 接 字 mysocket, 并 指定 服务 器 端 IP 地 址 与 端口 号 。 实 现 这 一 步 


又 也 可 先 指定 IP, 再 创建 客户 端 套 接 字 , 见 被 注释 的 第 22、23 行 ,如 果 使 用 这 种 创建 
Socket 的 方法 , 则 在 前 面 一 定 要 引入 java. net. InetAddress 类 。mysocket 对 象 一 旦 创 
建 ,即刻 与 服务 器 连接 上 了 。 


名 第 24 行 获得 一 个 DataInputStream 流 对 象 dinstream, 用 于 从 服务 器 中 得 到 一 个 流 信 息 。 
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S8 25 行 , 通 过 readUTF() 方 法 从 服务 器 的 输出 流 对 象 中 读 入 流 信息 。 

避 第 26 行将 从 服务 器 中 得 到 的 相关 信息 显示 在 EditText 中 。 

名 第 27 行 套 接 字 mysocket。 

© 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml, 添 加 网 络 访问 权限 ,其 代码 如 下 
所 示 。 

1 <?xml version= "1.0" encoding = "utf - 8"?> 


2 «manifest xmlns:android = "http: //schemas. android. com/apk/res/android" 
3 package = "cn. com. sgmsc. Socket" 


4 android:versionCode = "1" 

5 android:versionName = "1. 0"> 

6 « uses - sdk android:minSdkVersion = "10" /> 

7 

8 « application android: icon = "(Qdrawable/icon" android: label = "(Qstring/app name"» 
9 X activity android:name = ".ClientActivity" 

10 android: label = "(Zstring/app name"» 

11 < intent - filter > 

12 <action android:name = "android. intent. action. MAIN" /> 

13 < category android:name = "android. intent. category. LAUNCHER" /> 
14 </intent - filter» 

15 «/activity» 

16 

17 «/application» 

18 

19 < uses - permission android:name = "android. permission. INTERNET" /> 

20 

21 </manifest > 

第 19 行 添加 网 络 权限 。 


【运行 结果 】 在 Eclipse 中 ,首先 启动 服务 器 端的 程序 ,方法 是 选择 Socket. Server 项 目 名 
称 , 然 后 选择 菜单 Run- Run As-Java Application, 即 可 在 Eclipse 工作 窗口 下 方 的 Console 
窗口 中 看 到 如 *Listening.…” 的 信息 ,如 图 10-2 所 示 。 这 表明 服务 器 端 程序 已 成 功 启动 。 
TE Problems [© Console 53^. b Servers | @ Javadoc] [È Declaration mx X[ E OE 


MyServer (1) [Java Application] CAProgram FilesVava\jre6\bin\javaw.exe (2011-9-22 上 午 111104) 


Listening... 


Æ 10-2 刚 启 动 服务 器 端 程序 时 的 Console 窗口 


然后 启动 客户 端 程序 。 运 行 项 目 Socket_Client。 当 
连接 上 服务 器 后 出 现 如 图 10-3 所 示 的 界面 ,这 个 日 期 时 
间 值 串 来 自 于 服务 器 中 。 

这 时 再 看 一 下 Eclipse 的 Console 窗口 ,会 发 现 多 些 


信息 ,如 图 10-4 所 示 。 图 10-3 启动 客户 端 程序 的 运行 结果 
区 Problems (E Console :: ™ b Servers| @ Javadoc| [È Declaration: m xk EE)Sg-r--8 


MyServer (1) [Java Application] CAProgram FilesVava\jre6\bin\javaw.exe (2011-9-22 上 午 11:11:04) 
Listening... 
Client Connected... 


图 10-4 启动 了 客户 端 程序 后 的 Console 窗口 
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(0.2 获取 网 络 数据 资源 


由 于 移动 设备 的 存储 功能 有 限 ,有 许多 数据 是 保存 在 网 络 服务 器 中 。 本 节 介 绍 从 网 络 上 
获取 数据 资源 的 应 用 。Android 获取 网 络 上 的 资源 有 两 种 方式 一 一 使 用 URL 和 HTTP。 获 
取 网 络 资源 需要 使 用 Tomcat 服务 器 。 下 面 首先 介绍 如 何 设置 Tomcat 服务 器 。 


10.2.1 Eclipse 下 的 Tomcat 设置 


并 不 是 所 有 的 Eclipse 版 本 都 能 安装 Tomcat 服务 器 。 本 书 中 使 用 的 是 Eclipse 的 Jee 版 ， 
即 Eclipse IDE for Java EE Developers. ,可 从 网 址 http://www. eclipse. org/downloads/ 中 下 
载 得 到 。Jee 版 的 Eclipse, 没 有 像 MyEclipse 那样 集成 了 Tomcat, 需 要 自己 设置 。 在 Eclipse 
的 Jee 版 中 安装 并 设置 Tomcat 服务 器 的 步骤 如 下 。 

第 一 步 , 下 载 并 解压 Tomcat 。 下 载 Tomcat 7. 0. 11, 得 到 压缩 包 文件 apache-tomcat-7. 0. 11- 
windows-x86. zip ,并 解压 。 在 本 书 中 解压 路 径 为 E:\ apache-tomcat-7. 0.11, 

第 二 步 , 在 Eclipse 中 创建 Tomcat 服务 器 。 选 择 菜单 File New Other... ,打开 New 对 
话 框 ,选择 列表 框 中 的 Server 下 的 Server 项 ,如 图 10-5 所 示 。 

单 击 Next 按钮 ,进入 选择 Tomcat 版 本 的 对 话 框 。 选 择 Apache 下 的 Tomcat v7. 0 
Server 项 ,如 图 10-6 所 示 。 注 意 : 如 果 Next 或 Finish 按钮 都 是 灰 的 , 即 不 可 用 状态 ,那么 需 
要 选择 菜单 Window—> Preferences— Server Runtime Environments 进行 设置 ,新 建 一 个 
Tomcat 运行 环境 ,指定 Tomcat 的 路 径 和 jre。 


Define a New Server 
|| Choose the type of server to create A 
; 7 
Soloct a wizard = A ER 
Define a new server m aee Berat 
4 © Apache 
seai B Tomcat và 2 Server f 
type filter text 8 Tomcat 40 Server 

Vs ^ Bj Tomcat v4.1 Server. 
© Eclipse Modeling Framework B Tomcat v5.0 Server. 
EB B Tomcat v5.5 Server 
© Java 目 Tomcat v6.0 Server 
& Java EE [E] Tomcat v7.0 Server = 
(B Java Emitter Templates Publishes and runs J2EE and Java EE Web projects and server configurations to a 
9 JavaScript local Tomcat server. 
© JAXB. 
SPa Server's host name: localhost 
È Plug-in Development. 一 一 一 一 一 一 
8» Ramos 5yshim Explorer | Server name: Tomcat v7.0 Server at localhost 

|| | + © Server 

(serer) 
| 
| @ [ «9 (iiNet "i Frish Cancel | @ *Bek | Net " Finish Cancel 
图 10-5 f£ Server 图 10-6 ”选择 Tomcat 版 本 


单 击 Next 按钮 ,进入 指定 Tomcat 安装 文件 夹 的 对 话 框 。 在 Tomcat installation 
directory 中 输入 Tomcat 的 安装 文件 夹 (或 单 击 Browse... 按 钮 ,选择 Tomcat 的 安装 文件 夹 )， 
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在 JRE 下 拉 列 表 中 选择 jre7 项 , 单 击 Finish 按钮 ,如 图 10-7 所 示 。 

第 三 步 ,在 Eclipse 中 配置 Tomcat。 进 入 Eclipse 的 DDMS 页 中 ,选择 菜单 Window 
Show View-* Other... ,如 图 10-8 所 示 。 进 入 Show View 对 话 框 , 选 择 列表 框 中 的 Server 下 
的 Server 项 ,如 图 10-9 所 示 。 


[Eee | 


|| Tomcat Server 
Specify the installation directory 


Name: 

Apache Tomcat v7.0 
Tomcat installation directory: 
EAapache-tomcat-7.0.11 


JRE: 
ire? 


图 10-7 指定 Tomcat 安装 文件 夹 图 10-8 选择 菜单 过 程 


单 击 OK 按钮 ,进入 DDMS 页 的 Servers 窗口 ,如 图 10-10 所 示 。 
EE 


type fiter text. 


> © Debug B 
b G Help 

> © Java 

> @ Java Browsing 

> Q5 JavaScript 

b @ JavaServer Faces 

^ © JAX-WS 

?名 JPA 

> © Plug-in Development. | 


b £ Remote Systems 
4 (à Server. 


(f Servers) B*0Pmp"^"HU 


b © Tasks. 


edi - (f Tomcat v7.0 Server at localhost [Stopped] 


图 10-9 Show View 对 话 框 10-10 DDMS 页 中 的 Servers 窗口 


双击 Tomcat v7. 0 Server at localhost [Stopped] 项 ,打开 Tomcat v7. 0 Server at localhost 窗 
H ,进行 相关 属性 设置 。 在 此 窗口 中 主要 对 下 列 属性 进行 设置 : 在 Server Locations 里 ,选择 
Use Tomcat installation(takes control of Tomcat installation); 在 Server Options 里 ,选择 


Publish module contexts to separate XML files; 如 果 项 目 比 较 大 ,可 能 启动 时 间 较 长 ,需要 修 
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改 Timeouts 值 ; 还 可 以 设置 Tomcat 服务 器 的 端口 参数 等 ,如 图 10-11 所 示 。 


Hle edt Aelacor Rum Novgete Scarch Project Window Help 


n-H&i: AS a- Bsa 9-O-Q- #0- 
E Toma vI ser a kesha ~i 


g | 5 Overview 


图 10-11 Tomcat 服务 器 的 属性 设置 


第 四 步 ,启动 Tomcat 服务 器 。 在 Eclipse 的 DDMS 页 的 Servers 窗口 (如 图 10-10 所 示 ) 
或 在 Eclipse 的 Java 页 下 部 的 Servers 窗口 (如 图 10-12 所 示 ) 中 的 工具 按钮 中 有 一 个 “开启 ” 
按钮 O , 单 击 该 按钮 即 可 启动 Tomcat 服务 器 。 当 Tomcat 服务 器 是 启动 状态 时 ,该 工具 按钮 
的 “关闭 服务 ”按钮 图 可 用 。 如 果 要 关闭 服务 器 ,可 单 击 该 按钮 。 


[E Problems | 加 Console EIL. @ Javadoc) 区 Declaration | E% OE i: 


|B Tomcat v7.0 Server at localhost [Stopped] 
[ E d Start the server (Circ Alte) 


10-12 Java 页 中 的 Servers 窗口 


至 此 ,在 Eclipse Jee 中 配置 Tomcat 服务 器 已 经 完成 ,并 可 启动 Tomcat 服务 器 。 
10.2.2 通过 URL 获取 网 络 资源 


使 用 URL 获取 网 络 资源 ,需要 使 用 URL 类 和 URLConnection 类 ,这 两 个 类 都 位 于 
java. net 包 下 。 下 面 通过 一 个 案例 来 说 明 如 何 通过 URL 获取 网 络 的 资源 。 

【案例 10.2】 通过 URL 获取 服务 器 中 的 一 个 txt 文本 文件 和 一 个 png 图 片 文件 ,并 显 
示 在 手机 屏幕 上 。 

【说 明 】 通过 URL 访问 Tomcat 服务 器 上 的 文件 ,这 些 文件 一 般 都 是 放 在 Tomcat 的 
webapps 文件 夹 中 的 。 

本 例 中 ,Tomcat 服务 器 安装 在 本 地 机 上 ,本 机 的 IP 地 址 为 192. 168. 1. 102, Tomcat 服务 
器 的 端口 号 为 8080。 注 意 ,编程 时 不 要 使 用 localhost 或 127. 0. 0. 1, 因 为 这 是 Android 模拟 
器 的 IP 地址 。 

【开发 步骤 及 解析 】 

CD 准备 文件 。 在 Tomcat 的 webapps 文件 夹 中 创建 文件 夹 MyURLFiles ,分 别 将 一 个 
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txt 文本 文件 和 一 个 png 图 片 文件 复制 到 新 建 的 文件 夹 MyURLFiles 中 。 
(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 GetURLMsg 的 Android 项 目 。 其 应 用 程序 
名 为 GetURLDemo, 包 名 为 cn. com. sgmsc. geturl, Activity 组 件 名 为 GetURLDemoActivity。 
(3) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 
2 «LinearLayout xmlns:android = "http://schemas.android. com/apk/res/android" 


3 android:orientation = "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 > 

T < EditText 

8 android:id- "(9 + id/et" 

9 android:layout width- "fill parent" 

10 android:layout height = "wrap content" 

it android:editable - "false" 

12 android:cursorVisible = "false" 

13 android:layout gravity = "center horizontal" 

14 /> <! -- 声明 一 个 EditText 控件 --> 
15 < InageView 

16 android:id- "(9 + id/iv" 

17 android:layout width- "wrap content" 

18 android:layout height = "wrap content" 

19 android:layout gravity = "center horizontal" 

20 /> <! -- 声明 一 个 ImageView 控件 --» 
21 < Button 

22 android:id- "(9 + id/btn" 

23 android:text = "(à string/btn" 

24 android:layout width- "fill parent" 

25 android:layout height = "wrap content" 

26 android:layout gravity = "center horizontal" 

27 /> <! -- 声明 一 个 Button 控件 --> 


28 </LinearLayout > 


(4) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. geturl 包 下 的 GetURLDemoActivity. java 
文件 ,并 编辑 之 ,代码 如 下 所 示 。 


package cn. com. sgnsc. geturl; 


1 

2 

3 import java. io. BufferedInputStream; 
4 import java. io. InputStream; 

5 import java. net. URL; 

6 import java. net. URLConnection; 

y 
8 
9 


import org. apache. http. util. ByteArrayBuffer; 
import org. apache. http. util. EncodingUtils; 


11 import android. app. Activity; 

12 import android. graphics. Bitmap; 

13 import android. graphics. BitmapFactory; 
14 import android. os. Bundle; 

15 import android. view. View; 

16 import android. widget.Button; 

17 import android. widget. EditText; 
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18 import android. widget. ImageView; 


19 


20 public class GetURLDemoActivity extends Activity { 
String stringURL = "http://192.168.1.102:8080/MyUrlFiles/sgms msgl.txt"; 


21 


22 
23 
24 
25 
26 
27 
28 
29 
30 


56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 ) 


// 指 定 服务 器 上 的 文本 文件 名 


String bitmapURL = "http://192.168.1.102:8080/MyUrlFiles/sgms android. png"; 
(2 0verride 
public void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R. layout.main); 
Button btn = (Button)findViewById(R. id. btn) ; // 获 得 Button 控件 对 象 
btn. setOnClickListener(new View.OnClickListener() { 


Di 
) 


(2 Override 

public void onClick(View v) { // 重 写 onClick()Jrik 
getStringURLResources(); // 获 得 字符 串 资 源 
getBitmapURLResources() ; // 获 得 图 片 资源 


) 


// 方 法 ,根据 指定 URL 字符 串 获取 网 络 文本 资源 
public void getStringURLResources(){ 


try{ 


URL myUrl = new URL(stringURL); // 创 建 URL 对 象 
URLConnection myConn = myUrl. openConnection();// 打 开 连 接 
InputStream in = myConn.getInputStream(); // 获 取 输 入 流 
BufferedInputStream bis = new BufferedInputStream( in); 


// 获 取 Bu£feredInputStream 对 象 
ByteArrayBuffer baf = new ByteArrayBuffer(bis.available()); 
int data = 0; 
while((data = bis.read())!= -1){ // 读 取 BufferedInputStream 中 数据 
baf. append( (byte)data) ; // 将 数据 读 取 到 ByteArrayBuffer 中 
) 
String msg = EncodingUtils.getString(baf.toByteArray(), "UTF - 8"); 
// 转 换 为 字符 串 
EditText et = (EditText)findViewById(R. id.et);// 获 得 EditText 对 象 
et. setText(nsg) ; // 设 置 EditText 控件 中 的 内 容 
} 
catch(Exception e){ 
e. printStackTrace() ; 
} 
} 
// 方 法 ,根据 指定 URL 字符 串 获 取 网 络 图 片 资 源 
public void getBitmapURLResources(){ 
try{ 
URL myUrl = new URL(bitmapURL); // 创 建 URLXE 
URLConnection myConn = myUrl. openConnection();// 打 开 连 接 
InputStream in = myConn.getInputStream(); // 获 得 InputStream 对 象 


i 


Bitmap bmp = BitmapFactory.decodeStream(in); //®]Æ Bitmap 
ImageView iv = (ImageView)findViewById(R. id. iv); // 获 得 ImageView 对 象 
iv. setImageBitmap( bmp) ; // 设 置 ImageView 显示 的 内 容 


catch(Exception e){ 


e. printStackTrace(); 
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(D 58 21,22 行 是 定义 两 个 字符 串 变 量 ,分别 指定 存放 Tomcat 服务 器 上 MyUrlFiles 文件 
夹 下 的 sgms msgl. txt 和 sgms_android. png。 这 里 ,192. 168. 1. 102 和 8080 是 本 书 案 例 中 
Tomcat 服务 器 所 在 计算 机 的 TP 地 址 和 端口 号 ,读者 在 学 习 时 可 根据 自己 的 计算 机 的 IP 地 址 
来 蔡 换 例子 中 的 IP 地 址 。 在 程序 中 ,将 这 两 个 文件 的 地 址 存放 在 变量 中 的 好 处 在 于 ,如 果 IP 
地 址 和 端口 号 改变 了 ,只 需 修改 变量 定义 处 ,而 不 必 在 程序 中 到 处 寻找 要 修改 的 值 。 

@ 本 案例 将 从 Tomcat 服务 器 中 获得 的 文本 文件 和 图 片 文件 资源 的 相关 操作 分 别 封装 在 
自 定义 的 方法 getStringURLResources() 和 getBitmapURLResources() 内 , 见 第 31,32 fF. 

© 58 36—55 fr. 3E 3L. Tomcat 服务 器 中 获得 的 文本 文件 方法 getStringURLResources()。 
第 39 一 41 行 ,首先 创建 一 个 URL 对 象 myUrl, 该 对 象 指定 服务 器 上 的 文本 文件 sgms. msgl. txt. 
然后 打开 myUrl 的 URL 连接 myConn, 从 连接 中 获取 输入 流 in。 使 用 URL 获取 资源 ,这 是 
必 做 的 三 部 曲 。 接 下 来 由 输入 流 创 建 一 个 输入 流 缓冲 区 ,将 数据 读 入 这 个 缓冲 区 中 ,并 将 读 取 
的 数据 转换 为 UTF-8 格式 的 字符 串 ,再 由 EditText 控件 显示 出 来 。 

(D 第 57 一 69 行 ,定义 从 Tomcat 服务 器 中 获得 文本 文件 的 方法 getBitmapURLResourcesO 。 
第 62 行 创建 一 个 Bitmap 对 象 bmp ,然后 由 ImageView 控件 将 bmp 显示 出 来 。 

(5) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml, 添加 网 络 访问 权限 , 即 在 
所 manifest 之 标签 下 添加 一 条 代码 : 


< uses - permission android:name = "android. permission. INTERNET" /> 

【运行 结果 】 首先 将 Eclipse 中 的 Tomcat 服务 器 打开 ,然后 在 Eclipse 的 Android 模拟 
器 上 运行 GetURLMsg 项 目 。 初 始 运行 的 显示 效果 如 图 10-13 所 示 。 当 单 击 “获取 URL VE 
源 ” 按 钮 后 ， 从 Tomcat 服务 器 中 获取 文本 文件 内 容 和 图 片 文件 的 内 容 , 并 显示 出 来 ,效果 如 
图 10-14 所 示 。 


"GetURLDemo: 


获取 URL 资 源 


MF, REAREA, AES 
过 URL 传 来 的 网 络 数据 ! 


获取 URL 资 源 


图 10-13 运行 的 初始 界面 图 10-14 单 击 “获取 URL 资源 ”按钮 后 


使 用 URL 方式 从 网 络 服务 器 中 获取 资源 的 使 用 方法 就 这 么 简单 。 在 获取 字符 资源 时 通 
常 需要 作 格 式 转换 。 因 为 不 同 的 字符 集 确 定 不 同 的 字符 编码 ,当然 也 确定 了 字符 显示 的 表现 。 
UTF-8 格式 是 一 种 被 广泛 应 用 的 编码 ,这 种 编码 致力 于 把 全 球 的 语言 纳入 到 一 个 统一 的 编码 
中 ,目前 已 经 涵盖 了 几 种 亚洲 语言 ,如 中 文 、 韩 文 、 日 文 等 。 
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10.2.3 通过 HTTP 获取 网 络 资源 


使 用 HTTP 请 求 获取 网 络 资源 ,包括 POST 和 GET 两 种 方式 。GET 和 POST 是 使 用 
HTTP 的 标准 协议 动词 ,用 于 编码 和 传送 变量 名 /变量 值 对 参数 ,并 且 使 用 相关 的 请 求 语义 。 
每 个 GET 和 POST 都 由 一 系列 HTTP 请 求 头 组 成 ,这 些 请 求 头 定义 了 客户 端 从 服务 器 请 求 
了 什么 ,而 响应 则 是 由 一 系列 HTTP 应 答 头 和 应 答 数据 组 成 ,如 果 请 求 成 功 则 返回 应 答 。 

但 是 GET 和 POST 传送 方式 不 一 样 ,GET 传送 的 变量 名 /变量 值 是 作为 URL 的 一 部 分 
被 传送 ,在 URL 中 可 以 看 到 ,使 用 这 种 方式 传送 的 数据 量 较 小 , 且 安 全 性 非常 低 ; 而 POST 传 
送 的 变量 名 /变量 值 则 是 放 在 实际 的 HTTP 请 求 消息 内 部 被 传送 ,用 户 看 不 到 这 个 过 程 , 使 用 
这 种 方式 传送 的 数据 量 较 大 , 且 安 全 性 较 高 。 

在 Android 中 使 用 GET, POST 与 网 络 传送 或 获取 资源 需要 用 到 许多 位 于 org. apache. 
http 包 下 的 类 ,其 中 有 两 个 重要 的 类 是 HttpGet、HttpPost, 它们 都 位 于 org. apache. http. 
client. methods 包 下 ,是 用 来 向 网 络 服务 器 提交 GET, POST 的 请 求 。 使 用 HttpGet 或 
HttpPost 对 象 ,都 必须 通过 如 下 三 步 来 访问 HTTP 资源 。 

CD 创建 HttpGet 或 HttpPost 对 象 ,将 要 请 求 的 URL 通过 构造 方法 传人 HttpGet 或 
HttpPost 对 象 。 

(2) 使 用 DefaultHttpClient 类 的 execute() 方 法 发 送 HTTP GET 或 HTTP POST 请 求 ， 
并 返回 HttpResponse 对 象 。 

(3) 通过 HttpResponse 接口 的 getEntity() 方 法 返回 响应 信息 ,并 进行 相应 的 处 理 。 

但 是 HTTP GET 请 求 和 HTTP POST 请 求 在 实际 编程 中 是 有 区 别 的 ,具体 代码 如 下 。 


1. HTTP GET 请 求 


String url; //url 中 存放 网 络 资源 所 在 的 URL, 包含 变量 名 和 值 
/* 第 一 步 ,创建 HttpGet 对 象 * / 
HttpGet get_request = new HttpGet(url); 
/* 第 二 步 ,使 用 execute( ) 方 法 发 送 HTTP GET 请 求 , 并 返回 HttpResponse 对 象 * / 
HttpResponse get response = new DefaultHttpClient().execute(get request); 
if (get response.getStatusLine().getStatusCode() == 200)  // 当 状态 码 为 200 时 说 明 请 求 成 功 
{ 
/* 第 三 步 ,使 用 getEntity() 方 法 获得 返回 结果 * / 
String result = EntityUtils. toString(get_response. getEntity()); 
] 


2. HTTP POST 请 求 


String url; //url 中 存放 网 络 资源 所 在 的 URL 

/* 第 一 步 ,创建 HttpPost 对 象 * / 

HttpPost post request = new HttpPost(url); 

/* 设置 HTTP POST 请 求 参数 必须 用 NaneValuePair 对 象 * / 

List< NameValuePair > params = new ArrayList < NameValuePair»(); 

params. add(new BasicNameValuePair("bookname", etBookName.getText().toString())); 
/* iR post request 请 求 参数 / 

post request. setEntity(new UrlEncodedFormEntity(params, HTTP.UTF 8)); 

/* 第 二 步 ,使 用 execute() 方 法 发 送 HTTP GET 请 求 ,并 返回 HttpResponse 对 象 * / 
HttpResponse post response = new DefaultHttpClient().execute(post request); 
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if (post response.getStatusLine().getStatusCode() == 200) 

i /* 第 三 步 ,使 用 getEntity() 方 法 获得 返回 结果 * / 

String result = EntityUtils.toString(post_response. getEntity()); 

) 

下 面 通过 一 个 案例 来 说 明 使 用 GET 和 POST 获取 网 络 资源 的 用 法 。 

【案例 10.3】 分 别 通过 GET 和 POST 向 网 络 发 送 用 户 名 和 密码 ,如 果 用 户 名 和 密码 与 
网 络 上 文件 中 的 信息 一 致 则 反馈 通过 信息 ,否则 反馈 不 正确 信息 。 

【说 明 】 通过 GET 和 了 POST 向 网 络 服务 器 中 发 送 用 户 名 和 密码 ,使 用 该 网 络 上 的 一 个 
文件 (例如 http://dev. 3gmsc. com/test. php) ,来 比 对 传 来 的 用 户 名 和 密码 是 否 正 确 , 在 该 文 
件 中 ,用 户 名 为 “KongFu”, 密 码 也 为 “KongFu”, 并 根据 比 对 的 结果 向 客户 端 返回 相应 的 信息 。 

本 案例 没有 采用 互联 网 上 的 获取 数据 资源 的 做 法 ,因为 无 法 保证 这 个 文件 test. php 是 否 
永远 在 http://dev. 3gmsc. com/ 中 , 它 有 可 能 在 某 个 时 候 被 删除 掉 。 但 是 在 实际 应 用 中 ,一 般 
是 采取 这 种 方式 将 文件 存放 于 网 络 服务 器 上 的 。 作 为 举例 ,这 里 将 网 络 上 的 文件 test. jsp f£ 
放 在 本 机 的 Tomcat 服务 器 的 根 目录 中 (Tomcat 服务 器 根 目录 路 径 为 E:\apache-tomcat-7. 0. 11N 
webapps\ROOT)。 前 面 已 经 提 到 过 ,本 机 的 IP 地 址 为 192. 168. 1. 102 ,所 以 这 个 文件 的 IP 
地 址 为 http://192. 168. 1. 102/test. jsp。 注 意 在 Tomcat 服务 器 中 只 能 使 用 jsp 文件。 我们 
使 用 这 个 文件 来 对 上 传 来 的 用 户 名 和 密码 值 进 行 比 对 ,在 该 文件 中 ,用 户 名 为 “KongFu”, 密 码 
也 为 “KongFu”, 并 完成 信息 反馈 。 该 文件 代码 如 下 所 示 。 


1 <%@ page language = "java" import = "java.util. * " pageEncoding = "ISO - 8859 - 1" &» 
2 <$% 

3 String thisname, thispwd, regMethod, regParam; 

4 String[] paran; 

5 thisname - ""; 

6 thispwd = ""; 

7 reqMethod = request. getMethod(); 

8 


9 if (regMethod. equals("GET")) ( 


10 regParam = request.getQueryString(); 

11 if (regParam !- null) ( 

12 param = reqParam. split("&"); 

13 thisname - param[0].substring("name".length() * 1); 
14 thispsd = param[1].substring("pwd".length() + 1); 
15 ) 

16 

17 ) else if (reqMethod. equals("POST")) ( 

18 thisname - request.getParameter("name"); 

19 thispwd = request.getParameter("pwd"); 

20 } 

21 

22 if (thisname. equals("KongFu") &&this pwd. equals("KongFu")) { 

23 out.println(regMethod * " was used. Hello, " * thisname); 
24 } else( 

25 out. println("Failed to sign in!"); 

26 ) 

27 

28 $> 


CD 58 9—15 行 ,判断 当 使 用 GET. 方式 上 传 时 , 取 上 传 来 的 name 参数 的 值 给 变量 
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thisname, 取 上 传 来 的 pwd 参数 的 值 给 变量 thispwd。 

(2) 第 17 一 20 行 , 当 使 用 POST 方式 上 传 时 , 取 上 传 来 的 name 参数 的 值 给 变量 
thisname, 取 上 传 来 的 pwd 参数 的 值 给 变量 thispwd。 

(3) 第 22—26 行 ,判断 变量 thisname 和 thispwd 的 值 是 否 为 “KongFu” 和 “KongFu”, 如 
果 一 致 则 返回 正确 信息 ,例如 使 用 GET 方式 , 则 返回 信息 为 “GET was used. Hello, 
KongFu"; 如 果 不 一 致 则 返回 信息 “Failed to sign inl”. 

【开发 步骤 及 解析 】 

CD 准备 文件 。 将 准备 好 的 test. jsp 文件 复制 到 本 机 的 Tomcat 文件 夹 下 的 webappsN 
ROOT 文件 夹 下 ,例如 本 书 所 用 的 文件 夹 为 E: Napache-tomcat-7. 0. 11\webapps\ROOT。 

(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Get_PostConn 的 Android 项 目 。 其 应 用 程序 名 
为 Get_Post_Conn, 包 名 为 cn. com. sgmsc. httpconn Activity 组 件 名 为 Get_PostConnActivity。 

(D 准备 字符 串 资 源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


<?xml version = "1.0" encoding = "utf - 8"?> 
< resources > 


< string name = "app_name"> Get_Post_Conn </string> 
< string name = "local url"» http://192.168.1.102:8080/test. jsp </string> <! -- 本 地 机 服 
务 器 上 文件 所 在 地 址 --> 

7 <string name= "remote url"» http://dev.3gmsc. com/test.php</string> <! -- 远程 网 络 中 的 
文件 所 在 地 址 --> 


è 
2 
3 
4 «string name= "hello"> Hello World, Get_PostConnActivity!</string> 
5 
6 


8 
9 </resources > 


在 这 里 提供 了 网 络 上 指定 文件 的 地 址 信息 , 供 程序 使 用 。 
CD 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 
2 <LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


3 android:layout width- "fill parent" 

4 android:layout height = "fill parent" 

5 android:orientation = "vertical" > 

6 

7 < LinearLayout 

8 android:layout width- "fill parent" 

9 android:layout height = "wrap content" 

10 android:orientation = "horizontal" > 

1 

12 < TextView 

13 android: id= "(9 + id/userName" 

14 android:layout width = "80dip" 

15 android:layout height = "wrap content" 
16 android:text = "UserName:" /» 

17 

18 < EditText 

19 android:id="@ + id/etName" 

20 android:layout width- "wrap content" 
21 android:layout height = "wrap content" 
22 android:layout weight - "1" 


23 android:ems = "10" > 
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24 

25 < requestFocus /> 

26 </EditText> 

27 

28 «/LinearLayout > 

29 

30 < LinearLayout 

31 android:layout width- "fill parent" 

32 android:layout height = "wrap content" > 
33 

34 < TextView 

35 android:id- "(9 + id/tvPasswd" 

36 android:layout width = "80dip" 

37 android:layout height = "wrap content" 
38 android: text = "Password:" /> 

39 

40 < EditText 

41 android: id = "(à + id/etPasswd" 

42 android:layout width- "wrap content" 
43 android:layout height = "wrap content" 
44 android:layout weight - "1" 

45 android:ems - "10" 

46 android: inputType = "textPassword" /> 
47 

48 «/LinearLayout > 

49 

50 X Linearlayout 

51 android:layout width- "fill parent" 

52 android:layout height = "wrap content" 

53 android:gravity = "center" > 

54 

55 « Button 

56 android:id- "(à + id/btnGet" 

57 android:layout width = "60dip" 

58 android:layout height = "wrap content" 
59 android:text = "GET" /> 

60 

61 « Button 

62 android:id- "(9 + id/btnPost" 

63 id:layout width = "60dip" 

64 layout height = "wrap content" 
65 id:text = "POST" /> 

66 

67 «/LinearLayout > 

68 


69 «/LinearLayout > 


(D 第 7 一 28 行 定义 了 一 个 横向 的 LinearLayout 布局 ,标签 二 TextView 77 f UH. android; 
layout weight 属性 ,那么 这 个 控件 占 它 指定 的 宽度 ,标签 二 EditText 二 设置 android: layout. | 
weight 王 1, 说 明 它 占 余下 的 宽度 。 

© 58 23 行 ,属性 android ems— " 10" RR — Edit Text fifi A SE BEA 10 个 字符 。 

@ 第 25 ÍF, —requestFocus /二 表示 这 个 控件 将 获得 焦点 。 

QD 58 46 íT. JRE android :inputType — " textPassword" XR i — Edit Text — lf] sj A 77 3X 
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为 密码 输入 方式 , 即 隐藏 输入 内 容 。 
(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. httpconn 包 下 的 Get_PostConnActivity. 


java 文件 ,并 


25 
26 
27 
28 


编辑 之 。 代 码 如 下 所 示 。 


package cn. com. sgnsc. httpconn; 


import java. util. ArrayList; 
import java. util. List; 


import org 
import org. 
import org. 
import org 
import org. 
import org. 
import org. 
import org. 
import org. 


import android. 
import android. 


import and. 
import and. 
import and. 


import android. 


.apache. http. 
. apache. http. 
. apache. http. 
. apache. http. 
. apache. http. 
. apache. http. 
. apache. http. 
. apache. http. 
. apache. http. 


roid. 
roid. 
roid. 


HttpResponse; 

NameValuePair; 

client. entity. UrlEncodedFormEntity; 
client. methods. HttpGet; 

client. methods. HttpPost; 

impl. client. DefaultHttpClient; 
message. BasicNameValuePair; 
protocol. HTTP; 

util. EntityUtils; 


app. Activity; 

os. Bundle; 

view. View; 

view. View. OnClickListener; 
widget. Button; 

widget. EditText; 


import android. widget. Toast; 


public class Get_PostConnActivity extends Activity{ 
private Button btnGet, btnPost; 
private EditText etName, etPwd; 
private String httpUrl; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R. layout. main); 


etName = (EditText)findViewById(R. id. etName) ; 
etPwd = (EditText)findViewById(R. id. etPasswd) ; 
btnGet = (Button)findViewById(R. id. btnGet) ; 

btnPost = (Button)findViewById(R. id.btnPost); 


httpUrl = this.getString(R.string.local url); // 取 本 地 服务 器 中 文件 内 容 的 URL 地 址 
// httpUrl = this.getString(R. string. remote_url);// 取 远程 网 络 的 文件 内 容 的 URL 地 址 


btnGet. setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
HttpGet get_request = new HttpGet( 
String.format(" % s?name = % s&pwd- 5 s",httpUrl, etName. getText (), etPwd. getText () ) 
); ”// 根 据 内 容 来 源 地 址 创建 一 个 Http 请 求 


try ( 


/* 发 送 请 求 并 等 待 响 应 * / 
HttpResponse get response = new DefaultHttpClient().execute(get request); 
/* 若 状态 码 为 200, 说 明 请 求 已 经 成 功 * / 
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if (get response.getStatusLine().getStatusCode() == 200) { 

String get result = EntityUtils.toString(get response.getEntity()); 

// 读 返回 数据 
Toast.makeText(Get PostConnActivity. this, 
get result, Toast. LENGTH LONG) . show() ; 
) 
} catch (Exception e) ( 
Toast. makeText(Get PostConnActivity.this , 
e.getMessage().toString(), Toast.LENGTH LONG).show(); 


) 
n»; 


btnPost. setOnClickListener(new OnClickListener() { 
(QOverride 
public void onClick(View v) ( 
HttpPost post request - new HttpPost(httpUrl); 
// 根 据 内 容 来 源 地 址 创建 一 个 Http 请 求 
/* 创建 一 个 ArrayList 对 象 ,向 其 中 添加 若干 个 键 - 值 对 * / 
List < NameValuePair > params = new ArrayList < NameValuePair >(); 
params. add (new BasicNameValuePair("name", etName.getText(). toString())); 
// 添 加 键 - 值 对 
params. add(new BasicNameValuePair("pwd", etPwd.getText().toString())); 
try { 
/* 设置 参数 的 编码 * / 
post request. setEntity(new UrlEncodedFormEntity(params, HTTP. UTF_8)); 
/* 发 送 请 求 并 获取 反馈 * / 
HttpResponse post response = new DefaultHttpClient(). execute(post request); 
if (post response.getStatusLine().getStatusCode() -- 200) ( 
String post result = EntityUtils.toString(post response. getEntity()); 
Toast. makeText(Get PostConnActivity. this, 
post result, Toast. LENGTH. LONG). show() ; 
) 
) catch (Exception e) ( 
Toast.makeText(Get PostConnActivity. this, 
e.getMessage().toString(), Toast.LENGTH LONG).show(); 


(D 第 2.3 行 ,引入 相关 java. util 的 类 ; 第 6 一 14 行 引入 相关 org. apache. http 包 下 的 类 。 
@ 第 39、40 行 提供 了 从 两 个 网 络 上 取 资 源 的 地 址 ,在 本 例 中 使 用 第 39 行 指定 的 地 址 ,如 


果 想 从 互联 网 上 获取 资源 ,可 把 第 39 行 改 为 注释 ,去 掉 第 40 行 的 注释 符号 ,并 运行 本 项 目 。 


© 第 46 行 ,使 用 方法 String. format C" % s?name = % s&-pwd=%s", httpUrl, etName. 


get TextO , etPwd. getText() ) 得 到 一 个 字符 串 。 其 被 双 引 号 括 起 来 的 部 分 是 指定 字符 串 的 
格式 ,其 后 的 字符 串 变 量 个 数 和 顺序 与 相应 的 *%s” 对 应 , 即 第 一 个 “%s” 由 httpUrl 中 的 值 蔡 
换 , 第 二 个 “%s” 由 etName. getText() 的 值 替 换 , 第 三 个 “%s” 由 etPwd. getText() 的 值 替换 。 


@ 58 69—71 行 是 定义 一 个 ArrayList 对 象 ,向 其 中 添加 两 个 键 - 值 对 ,为 使 用 POST 方 式 


传送 准备 数据 。 注 意 这 段 代码 一 定 要 在 onCreate() 方 法 内 定义 。 


(6) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml. 添加 网 络 访问 权限 , 即 在 
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一 manifest 过 标签 下 添加 一 条 代码 : 

< uses - permission android:name = "android. permission. INTERNET" /> 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 Get. PostConn 项 目 ,显示 用 
户 名 、 密 码 输 入 界面 ,这 时 分 别 输入 “KongFu” 和 “KongFu”, 如 图 10-15 所 示 。 如 果 单 击 GET 
按钮 ,可 以 看 到 输入 信息 正确 的 回馈 消息 提示 ,如 图 10-16 所 示 ; 如 果 单 击 POST 按钮 ,可 以 
看 到 如 图 10-17 所 示 的 提示 信息 。 


Fd 


GET was used. Hello, KongFu POST was used. Hello, KongFu 


图 10-15 输入 了 用 户 名 和 密码 Æ 10-16 Sid GET 按钮 之 后 图 10-17 单 击 POST 按钮 之 后 


当然 ,也 可 以 不 按 正确 的 用 户 名 和 密码 输入 ,看 看 回馈 消息 会 是 什么 ? 


10.3 浏览 网 页 


在 Android 中 进行 浏览 网 页 的 开发 非常 简单 ,可 使 用 两 种 方式 ,一 是 使 用 Intent 组 件 ,二 
是 使 用 WebView 控件 。 


10.3.1 使 用 Intent 组 件 浏 览 网 页 


Intent 是 Android 平台 上 的 一 个 重要 组 件 , 使 用 它 可 以 调用 系统 中 的 Web 浏览 器 应 用 。 
例如 要 浏览 Google 中 国 香港 的 网 页 ,其 关键 代码 为 : 

Uri uri = Uri.parse("http://www. google. con. hk/") ; 

Intent intent = new Intent(Intent. ACTION VIEW,uri); 

startActivintenty(intent); 

下 面 简 单 地 用 一 个 案例 说 明 其 用 法 。 

【案例 10.4】 使 用 Intent 组 件 开发 一 个 浏览 网 页 应 用 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 Browserlntent 的 Android 项 目 。 其 应 用 程序 名 


为 BrowserIntent, 包 名 为 cn. com. sgmsc. BrowserIntent, Activity 组 件 名 为 BrowserIntentActivity。 
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(2) 准备 字符 串 资源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 «resources? 


3 

4 < string name = "app name"» BrowserIntent «/string? 
5 < string name = "go button"» Go«/string» 

6 

7 «/resources» 


(3) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <LinearLayout 

2 xmlns:android = "http://schemas.android. com/apk/res/android" 
3 android:orientation = "horizontal" 

4 android:layout width- "fill parent" 

5 android:layout height = "fill parent"» 

6 < EditText 

7 android: id = "(à + id/url field" 

8 android:layout width- "wrap content" 
9 android:layout height = "wrap content" 
10 android:layout weight = "1.0" 

11 android: lines = "1" 

12 android: inputType = "textUri" 

13 android:imeOptions = "actionGo" /> 

14 < Button 

15 android: id = "@ + id/go button" 

16 android:layout width- "wrap content" 
17 android:layout height = "wrap content" 
18 android:text = "(Qstring/go button" /> 


19 «/LinearLayout > 


(4) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Browserlntent 43 F 的 BrowserlIntentActivity. 
java 文件 ,并 编辑 之 。 代 码 如 下 所 示 。 


package cn. con. sgnsc. BrowserIntent; 


z 

2 

3 import android. app. Activity; 

4 import android. content. Intent; 

5 import android. net. Uri; 

6 import android. os. Bundle; 

7 import android. view. KeyEvent; 

8 import android. view. View; 

9 import android. view. View. OnClickListener; 
10 import android. view. View. OnKeyListener; 

11 import android. widget. Button; 

12 import android. widget. EditText; 

13 

14 public class BrowserIntentActivity extends Activity { 
15 private EditText urlText; 

16 private Button goButton; 

17 

18 @Override 

19 public void onCreate(Bundle savedInstanceState) { 
20 super. onCreate(savedInstanceState); 
21 setContentView(R. layout.main); 

22 
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23 urlText = (EditText) findViewById(R. id.url field); 
24 goButton = (Button) findViewById(R. id.go button); 
25 

26 goButton. setOnClickListener(new OnClickListener() ( 
27 public void onClick(View view) ( 

28 openBrowser() ; 

29 } 

30 Hi 

31 urlText. setOnKeyListener(new OnKeyListener() { 

32 public boolean onKey(View view, int keyCode, KeyEvent event) { 
33 if (keyCode == KeyEvent. KEYCODE ENTER) ( 

34 openBrowser() ; 

35 return true; 

36 } 

37 return false; 

38 } 

39 13; 

40 } 

41 

42  /* 打开 EditView 中 指定 URL 的 网 页 */ 

43 private void openBrowser() { 

44 Uri uri = Uri.parse(urlText.getText().toString()); 
45 Intent intent = new Intent(Intent. ACTION VIEW, uri); 
46 startActivity( intent); 

47 } 

48 } 

(D 第 26 一 30 行 ,为 按钮 添加 一 个 OnClickListener() 监 听 , 第 31 一 39 行 ,为 EditView 的 


控件 urlText 添加 一 个 OnKeyListener CO 监听 ,在 两 个 监听 的 回调 方法 中 都 调用 了 
openBrowser() 方 法 ,在 该 方法 中 编写 打开 网 页 的 代码 。 

© $ 33 ÍT. if (keyCode == KeyEvent. KEYCODE_ENTER) 是 判断 按 下 的 键 是 否 为 回 
车 键 ,只 有 在 按 下 回 车 键 时 才能 调用 openBrowser() 方 法 。 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 BrowserIntent M H ,在 文本 
编辑 框 中 可 以 输入 完整 的 网 址 ,如 图 10-18 所 示 , 当 单 击 Go 按钮 后 ,或 者 在 输入 框 中 按 回 车 键 
后 ,打开 该 网 页 ,如 图 10-19 所 示 。 
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BrowserIntent 


http://www.google.com.hk/ B" 


Google.com hk 使 用 下 列 语言 


图 10-18 在 编辑 框 内 输入 网 址 图 10-19 打开 输入 网 址 的 网 页 
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10.3.2 使 用 WebView 控件 浏览 网 页 


WebView 类 位 于 android. webkit 包 下 , 它 可 以 对 网 页 浏览 和 控制 进行 设置 ,常用 的 方法 
如 表 10-1 所 示 。 


表 10-1 WebView 类 常用 的 方法 及 说 明 


5 法 描 x 


setJavaScriptEnabled( Boolean flag) 设置 网 页 中 是 否 支 持 JavaScript, WR flag 为 true, W fè 
许 WebView 可 以 执行 JavaScript 
setHorizontalScrollBarEnabled(Boolean enable) 设置 水 平 滚动 条 的 显示 /隐藏 。 如 果 enable 为 true, 则 显 


示 水 平 滚动 条 
loadUrl (Url url) 打开 url 指定 的 网 页 
goBack() 向 后 显示 浏览 过 的 页 面 
goForward() 向 前 显示 浏览 过 的 页 面 


下 面 使 用 一 个 简单 案例 来 说 明 WebView 的 用 法 。 

【案例 10.5】 使 用 WebView 控件 开发 一 个 浏览 网 页 应 用 。 

GAJ 使 用 WebView 开发 浏览 网 页 应 用 时 ,需要 在 AndroidManifest. xml 中 添加 网 络 
权限 。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 BrowserView 的 Android 项 目 。 其 应 用 程序 名 为 
BrowserView, 包 名 为 cn. com. sgmsc. BrowserView, Activity 组 件 名 为 BrowserViewActivity。 

(2) 准备 字符 串 资源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,该 文件 与 案例 10. 4 
中 的 strings. xml 文件 内 容 相似 ,在 此 省 略 其 代码 显示 。 

G) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 <LinearLayout 

3 xmlns:android = "http://schemas. android. com/apk/res/android" 

4 android:orientation = "vertical" 

5 android:layout width- "fill parent" 
6 android:layout height = "fill parent" 
7 
8 


< LinearLayout 
android:orientation = "horizontal" 


9 android:layout width- "fill parent" 

10 android:layout height = "wrap content" 

a: < EditText 

12 android:id="@ + id/url_field" 

13 android:layout width- "wrap content" 
14 android:layout height = "wrap content" 
15 android:layout weight - "1.0" 

16 android:lines - "1" 

17 android: inputType = "textUri" 

18 android: imeOptions = "actionGo" /> 

19 < Button 

20 android: id = "(à + id/go button" 

21 android:layout width- "wrap content" 
22 android:layout height = "wrap content" 


23 android: text = "(Zstring/go button" /> 
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24 </LinearLayout > 

25 < WebView 

26 android:id- "(9 + id/web view" 

27 android:layout width- "fill parent" 
28 android:layout height = "wrap content" 
29 android:layout weight = "1.0" /> 


30 «/LinearLayout > 


1d Js I rp ERIS DL 4 — WebView2 fi AE . E 25—29 行 。 
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(4) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. BrowserView 包 下 的 BrowserViewActivity. java 


文件 ,并 编辑 之 。 代 码 如 下 所 示 。 
package cn. con. sgnsc. BrowserView; 


Li 
2 
3 import android. app. Activity; 

4 import android. os. Bundle; 

5 import android. view. KeyEvent; 

6 import android. view. View; 

7 import android. view. View. OnClickListener; 
8 import android. view. View. OnKeyListener; 

9 import android. webkit. WebView; 

10 import android. widget. Button; 

11 import android. widget. EditText; 


13 public class BrowserViewActivity extends Activity ( 
14 private EditText urlText; 

15 private Button goButton; 

16 private WebView webView; 


18 (QOverride 
19 public void onCreate(Bundle savedInstanceState) ( 


20 super. onCreate(savedInstanceState); 

21 setContentView(R. layout. main); 

22 

23 urlText = (EditText) findViewById(R. id.url field); 
24 goButton - (Button) findViewById(R. id.go button); 
25 webView = (WebView) findViewById(R. id.web view); 
26 

27 goButton. setOnClickListener(new OnClickListener() ( 
28 public void onClick(View view) ( 

29 openBrowser(); 

30 b 

31 D; 

32 urlText. setOnKeyListener(new OnKeyListener() { 

33 public boolean onKey(View view, int keyCode, KeyEvent event) ( 
34 if (keyCode == KeyEvent.KEYCODE ENTER) ( 

35 openBrowser(); 

36 return true; 

37 } 

38 return false; 

39 } 

40 Di 

41 } 

42 


43 /x* 打 开 EditView 中 输入 网 址 的 网 页 * / 
44 private void openBrowser() ( 
45 webView.getSettings().setJavaScriptEnabled(true); 
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46 webView. loadUrl(urlText.getText().toString()); 


(D 该 逻辑 代码 的 编程 思想 与 案例 10. 4 的 相似 ,不 同 之 处 在 于 打开 网 页 的 自 定义 方法 
openBrowser( , 

© 第 45 行 ,设置 WebView 对 象 可 以 访问 页 面 中 有 JavaScript 的 网 页 。 现 在 的 网 页 一 般 
都 会 使 用 到 JavaScript 脚本 语句 编写 。 

(5) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest xml, 添 加 网 络 访问 权限 , 即 在 
manifest fg A£ rp ifs mn — Ak (85 : 

« uses - permission android:name = "android. permission. INTERNET" /> 

【运行 结果 】 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 BrowserView 项 目 ,在 文本 编 
辑 框 中 可 以 输入 完整 的 网 址 ,如 图 10-20 所 示 , 当 单 击 Go 按钮 后 ,或 者 在 输入 框 中 按 回 车 键 
后 ,打开 该 网 页 ,如 图 10-21 所 示 。 


& wi È 10:44 i wi d 1045 
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BrowserView 


http://www.google.com.hk 图 http://www.google.com.hR 图 
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Google 


图 10-20 在 编辑 框 内 输入 网 址 图 10-21 打开 输入 网 址 的 网 页 


读者 可 以 比较 一 下 这 两 个 案例 的 运行 界面 ,看 看 有 什么 区 别 ? 注意 ,如 果 在 应 用 程序 中 使 
用 WebView 对 象 多 了 ,会 影响 到 程序 的 执行 效率 。 


(0.4 定位 与 Google 地 图 


Google 公司 早 在 2005 年 就 推出 了 Google Maps 等 基于 位 置 的 服务 ，Android 出 自 
Google 之 手 , 那 么 将 诸如 GPS 定位 .Google Map、 天 气 预报 等 多 种 服务 应 用 到 Android 中 是 
自然 不 在 话 下 的 。 


10.4.1 Google 位 置 服务 


在 Android 的 位 置 服 务 中 ,有 两 个 重要 的 类 是 LocationManager 和 LocationProvider。 
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LocationManager 类 位 于 android. location 包 下 , 它 提供 了 用 于 访问 设备 位 置信 息 的 服务 ,这 
些 服务 可 以 使 应 用 程序 周期 性 地 获得 设备 的 位 置 数据 ,还 可 以 在 设备 的 地 理 位 置 满足 特定 条 
件 时 触发 Intent 广播 。LocationProvider 类 定义 了 位 置 服务 的 提供 方法 ,例如 ,是 由 GPS 设备 
提供 还 是 通过 网 络 提供 等 ,其 中 静态 字符 串 常 量 GPS_PROVIDER 表示 LocationProvider 是 
GPS, 静 态 字符 串 常 量 NETWORK. PROVIDER 表示 LocationProvider 是 网 络 。 


1. LocationManager 及 相关 类 的 方法 


LocationManager 类 的 对 象 通 过 Context. getSystemService (Context. LOCATION _ 
SERVICE) 方 法 获得 实例 。 一 旦 获得 LocationManager 的 实例 ,就 可 以 实现 获取 设备 的 位 置 、 
周期 性 地 更 新 位 置 等 功能 。 该 类 常用 的 方法 如 表 10-2 所 示 。 


表 10-2 LocationManager 常用 的 方法 及 说 明 


5 È 描 述 
addGpsStatusListener( GpsStatus. Listener listener) 添加 一 个 GPS 状态 监听 器 
getAllProviders() 获得 所 有 的 LocationProvider 列表 


getBestProvider(Criteria criteria, boolean enabledOnly) 传人 Criteria 对 象 ,返回 与 Criteria 对 象 设置 条 件 最 匹 
配 的 LocationProvider, 作 为 getLastKnownLocation 方 


法 的 传人 参数 
getLastKnownLocation (String provider) 根据 Provider 获得 位 置信 息 , 其 默认 的 Provider 是 
GPS。 该 方法 返回 一 个 封装 了 经 纬度 等 信息 的 
Location 对 象 
getProvider(String name) 获得 指定 名 称 的 LocationProvider 
requestLocationUpdates(String provider, long minTime, 通过 给 定 的 Provider 名 称 , 周 期 性 地 通知 当前 的 
float minDistance，PendingIntent intent) Activity, HP minTime 和 minDistance 代表 地 理 位 


置 更 新 的 最 小 时 间 间 隔 及 位 移 变化 的 最 短 距离 
requestLocationUpdates(String provider, long minTime， 添加 一 个 LocationListener 监听 器 。 其 中 provider 
float minDistance, LocationListener listener) 为 注册 的 provider 名 
removeUpdate( LocationListener listener) 移 除 指定 的 LocationListener 监听 器 


方法 中 涉及 一 个 Criteria 类 ,该 类 表示 了 应 用 程序 选择 位 置 服务 Provider 的 一 个 标准 。 

Provider 可 能 是 根据 精准 度 , 电 量 使 用 ,能 和 否 获得 海拔 ,速度 .方向 和 产生 资费 来 选择 的 。 

Criteria 类 提供 了 一 系列 的 set() 方 法 ,可 以 设置 多 种 因素 的 标准 ,LocationManager 可 以 根据 

这 个 设 定好 的 标准 ,自动 选择 最 适合 需求 的 Providers Criteria 类 常用 的 方法 如 表 10-3 所 示 。 
表 10-3 Criteria 常用 的 方法 及 说 明 


5 法 描 g 

setAccuracy(int accuracy) 设置 经 纬度 的 精准 度 。 可 选 参 数 有 ACCURACY FINE 
(准确 ) . ACCURACY COARSECHBE 

setAltitudeRequired(boolean altitudeRequired) ”设置 是 否 需要 获取 海拔 数据 

setBearingAccuracy(int accuracy) 设置 方向 的 精确 。 可 选 参数 有 ACCURACY_LOW( 低 )， 
ACCURACY_MEDIUM( 中 ),ACCURACY_HIGH( 高 )， 
NO_REQUIREMENT( 没 有 要 求 ) 

setBearingRequired(boolean bearingRequired) 设置 是 否 需要 获得 方向 信息 

setCostAllowed( boolean costAllowed) 设置 是 否 允许 定位 过 程 中 产生 资费 ,例如 流量 等 
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方 法 描 述 
setPowerRequirement(int level) 设置 耗 电量 的 级 别 。 可 选 参数 有 POWER_LOW( 低 )， 
POWERMEDIUM ( 8), POWER _ HIGH CR). NO _ 
REQUIREMENT (HARR) 
setSpeedAccuracy(int accuracy) 设置 速度 的 精确 度 
setSpeedRequired(boolean speedRequired) 设置 是 否 提供 速度 的 要 求 


2. 添加 位 置 变化 监听 器 


调用 LocationManager 类 的 getLastKnownLocation() 方 法 只 是 主动 地 查询 地 理 位 置信 
息 , 如 果 需 要 在 地 理 位 置信 息 发 生变 化 后 自动 通知 系统 ,可 以 为 LocationManager 添加 一 个 
LocationListener 监听 器 。 

通过 调用 LocationManager 的 requestLocationUpdates() 方 法 可 以 添加 一 个 LocationListener 
监听 器 ,调用 LocationManager 的 removeUpdates() 方 法 可 以 移 除 指定 的 LocationListener。 

在 LocationListener 监听 器 中 需要 实现 下 列 几 个 方法 ,分 别 描述 如 下 。 

(1) onLocationChanged(Location location) , 当 设备 位 置信 息 发 生变 化 时 调用 该 方法 。 

(2) onProviderDisabled(String provider) , 当 设备 的 Location Provider 被 禁用 时 调用 该 
方法 。 如 果 注 册 监 听 器 时 设备 已 经 禁用 了 Location Provider, 则 会 立即 调用 该 方法 。 

(3) onProviderEnabled ( String provider) , 当 设备 的 Location Provider 被 启用 时 调用 该 
方法 。 

(4) onStatusChanged(String provider. int status, Bundle extras). 当 设备 的 Location 
Provider 状态 发 生变 化 时 触发 该 方法 ,可 取 的 状态 为 TEMPORARILY UNAVAILABLE, 
OUT OF SERVICE 和 AVAILABLE。 


3. 地 理 位 置信 息 定位 应 用 开发 中 的 几 点 注意 


在 开发 地 理 位 置 定 位 应 用 时 需要 注意 以 下 几 个 问题 。 

1) 添加 相关 的 权限 

使 用 GPS 卫星 进行 定位 ,需要 在 AndroidManifest. xml 文件 中 的 二 manifest 二 标签 下 添 
加 获取 位 置地 理 信 息 的 权限 。 根 据 不 同 的 LocationProvider, 添 加 的 权限 也 有 些 细微 不 同 。 

(1) GPS 定位 。 

使 用 GPS 卫星 进行 定位 ,需要 添加 权限 android. permission. ACCESS_FINE_LOCATION 。 

(2) NETWORK 定位 。 

使 用 信号 接收 塔 和 WIFI 介入 点 进行 定位 ,需要 添加 权限 android. permission. ACCESS _ 
FINE_LOCATION (精确 定位 ) 或 android. permission. ACCESS. COARSE, LOCATION H 
糙 定 位 ) 。 

2) Android SDK 的 版 本 问题 

对 GPS 管理 的 功能 模块 ,在 Android SDK 版 本 不 同 的 情况 下 ,对 GPS 控制 的 代码 是 不 一 
样 的 。 在 SDK 2.2 及 以 下 的 版 本 中 ,可 以 利用 Android 平台 自 带 的 Widget 插件 对 各 种 开关 
进行 管理 ,从 而 实现 GPS 的 开关 。 使 用 前 面 介绍 的 方法 来 编写 代码 ,可 以 正常 运行 。 

但 在 2.3 版 本 里 面 ,需要 利用 SDK 中 的 类 Settings. Secure 的 一 个 静态 方法 ,那么 在 


第 10 章 ”网络 与 位 置地 图 


AndroidManifest. xml 中 需要 添加 “android. permission. WRITE_SECURE_SETTINGS” 权 
限 ,而 Google 把 这 个 权限 完全 锁 住 了 。 如 果 想 在 SDK2. 3 版 本 管理 GPS. 那么 只 能 使 用 
Intent 打开 系统 默认 的 管理 GPS 的 Activity 了 。 

3) 在 模拟 器 上 模拟 GPS 位 置 数据 

Google 位 置 服务 应 用 只 有 在 接 通 网 络 的 移动 设备 上 才 真 正 有 意义 ,如 Android 手机 , 平 
板 计 算 机 等 。 而 在 开发 中 使 用 的 模拟 器 是 没有 GPS 设备 的 ,在 运行 应 用 程序 时 需要 模拟 GPS 
位 置 数据 。 

设置 Eclipse 的 模拟 器 GPS 位 置 的 方法 有 两 种 ,一 
种 是 使 用 DDMS 工具 提供 的 Emulator Control, 另 一 种 
是 在 命令 行 状 态 使 用 命令 。 

(1) 使 用 DDMS 工具 的 操作 步骤 。 

首先 启动 Eclipse 的 模拟 器 ; 然后 进入 Eclipse 的 
DDMS 工具 ,选择 菜单 Window—> Show View 一 Other...， 
打开 Show View 对 话 框 ; 选择 Android 下 的 Emulator 
Control, 打 开 Emulator Control, 在 Location Controls Tali) [Hang Up. 
的 Manual 选项 卡 中 输入 模拟 的 地 理 位 置 经 纬度 ,这 Localion Controls 
默认 选择 Decimal( 十 进 制 ), 也 可 以 选择 sean uL. Jame: 
(六 十 进 制 ),Longitude 是 经 度 , Latitude 是 纬度 ， p © Sexagesimal 
在 输入 框 中 输入 一 对 经 ,纬度 数值 ,如 图 1022 所 示 ; 然 | a 
后 单 击 Send 按钮 即 完成 模拟 器 的 GPS 位 置 定位 。 E 

(2) 使 用 命令 的 操作 方法 

首先 进入 命令 行 状态 (在 Windows 中 运行 cmd 可 
执行 文件 ) ,然后 输入 下 列 命令 : 图 10-22 Emulator Control 对 话 框 


telnet localhost 5554 


该 命令 是 打开 模拟 器 ,其 中 5554 是 模拟 器 在 本 机 的 端口 ,不 同 的 模拟 器 端口 号 不 同 , 如 果 
在 Eclipse 中 打开 两 个 模拟 器 ,通常 第 一 个 模拟 器 是 5554, 第 二 个 模拟 器 是 5556 。 这 个 端口 号 
显示 在 模拟 器 左上 方 , 如 果 模 拟 器 端口 号 不 同 , 在 输入 命令 时 请 使 用 自己 的 模拟 器 端口 号 。 执 
行 了 该 命令 后 进入 Android 控制 台 状 态 ,如 图 10-23 所 示 。 


| 


图 10-23 输入 了 telnet 命令 之 后 进入 Android Console 


在 Android 控制 台 状 态 输 入 下 列 命令 。 

geo fix 113.23 23.17 

命令 的 格式 为 : geo fix 经 度 纬度 ,用 于 设置 Android 模拟 器 位 置 的 经 度 和 纬度 。 

注意 ,如 果 是 使 用 Windows 7 的 用 户 ,控制 台 可 能 会 提示 telnet 之 类 的 信息 ,因为 
Windows 7 系统 下 默认 是 不 出 现 telnet 的 ,需要 手动 打开 。 具 体操 作 步 又 如 下 。 
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(D 在 控制 面板 中 ,选择 “程序 ”, 单 击 “ 打 开 或 关闭 Windows 功能 ”, 进 入 *Windows 功能 ” 


对 话 框 ,将 “Telnet 服务 器 "和 “Telnet 客户 端 ” 勾 选 上 ,如 图 10-24 所 示 。 


打开 或 关闭 Windows 功能 e 
车 要 打开 一 种 功能 ， SURSMENEÜE, ESUXOD- MUSEOS, NE 
框 。 填 充 的 框 表示 仅 打 开 该 功能 的 一 部 分 。 


1) Internet E885 3 
Il jJ. Microsoft NET Framework 3.5.1 

m EJ Microsoft Message Queue (MSMQ) 服务 器 

S Ei NFS RS 

RAS EEEHESEESET RECMAK) 


IV. j. Telnet 服务 器 
TD Telnet EAR 
Ey TEAR id 


10-24 "Windows 功能 ”对 话 框 


© 仍 在 控制 面板 里 ,打开 “系统 和 安全 ”, 然 后 再 打开 “管理 工具 ”, 双击“ 服务 ”, 进 入 “ 服 


务 "窗口 ,将 Telnet 项 的 启动 类 型 由 “禁用 ” 改 为 “手动”, 完成 后 如 图 10-25 所 示 。 


文件 (月 REA EEV) EDH) 
外 中 | 因 日 6318T anw 


ee ^ mt us mon WES 
Q Task Scheduler — 使 用 .。 已 启动 生动 

Q TCP/IP NetBIOS .. 1868.. 已 启动 自动 

R Telephony. La 


m 

ARESECNFIUGHEUNEG  OTenps Cerifcat. 

F, HLASI TCP/IP Telnet 8 O Themes 为 用 

PUB. CEST UNIX 和 Windows a " 

的 计 其 如 果 比 服务 售 上 . 远 和 用 S Thread Orderin 提供 
" TPM Base Servic.. ti. 


CARREF 
tHESemRDER, Q UPnP Device Host. sti ... 
D User Profile Serv... HR. 
Virtual Disk 
A Volume Shadow... 
Ĝ WatchData ccb .. 
QQ WebClient 
G& Windows Audio 
(4, Windows Audio ... 
Q Windows Backup. 
G Windows Biome... Wir 
A Windows Cards-， 安 全 - 


图 10-25 “服务 ”窗口 
© 完成 上 述 操作 之 后 ,就 可 以 在 命令 行 状态 下 输入 telnet localhost 命令 和 geo fix 命令 了 。 
4. 中 国 几 个 城市 的 经 纬度 


K 10-4 中 列 出 了 中 国 几 个 大 中 城市 的 经 、 纬 度 , 这 些 经 纬度 数据 存在 细小 偏差 , 仅 供 


参考 。 
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表 10-4 中 国 几 个 城市 的 经 纬度 参考 数据 


城市 经 度 纬度 城市 经 度 纬度 

北京 116:28E 39:54N 青岛 120:19E 36:04N 
xm 117:10E 39:10N 郑州 113:42E 34:44N 
石家庄 114:26E 38:03N 开封 114:23E 34:52N 
上 海 121:26E 31:12N 泸州 105:27E 28:54N 
南京 118:46E 32:03N 万 县 108:22E 30:48N 
杭州 120:10E 30:15N 常德 111:39E 29:00N 
宁波 121:34E 29:53N 广州 113:18E 23:10N 


5. GPS 定位 简单 应 用 


【案例 10.6】 列 出 你 手机 所 在 的 位 置信 息 。 

【说 明 】 前 面 已 经 提 到 了 关于 SDK 的 版 本 问题 。 所 以 在 本 例 中 使 用 API Level 级 别 为 
8 的 模拟 器 来 运行 程序 ,因为 API Level 8 对 应 的 SDK 版 本 是 2.2。 否 则 可 能 得 不 到 预期 运行 
结果 。 

在 开发 GPS 定位 应 用 时 要 注意 所 使 用 的 Android SDK 版 本 ,由 于 版 本 的 不 同 ,在 编程 中 
对 GPS 控制 的 代码 也 不 一 样 。 和 希望 读者 要 注意 到 这 些 细节 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 MyLocation 的 Android 项 目 。 其 应 用 程序 名 
为 LocationDemo ,选择 Build Target 时 勾 选 Android 2. 2, 包 名 为 cn. com. sgmsc. Location, 
Activity 组 件 名 为 LocationDemoActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version = "1.0" encoding = "utf - 8"?> 


2 <LinearLayout xmlns:android= "http://schemas.android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 
6 > 

7 <EditText 

8 android: id= "(9 + id/et" 

9 android:layout width- "fill parent" 
10 android:layout height = "wrap content" 
11 android:cursorVisible = "false" 

12 android:editable = "false" 

13 /> 


14 </LinearLayout > 


第 11 行 定义 该 EditText 控件 内 的 光标 不 可 见 。 第 12 行 定义 该 EditText 控件 不 可 编 
辑 。 定 义 了 这 两 个 属性 ,那么 这 个 EditText 只 能 用 于 显示 信息 。 

(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Location 包 下 的 Service_BdcastActivity. 
java 文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 

1 package cn. com. sgnsc. Location; 


2 
3 import android. app. Activity; 
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import android. content. Context; 

import android. content. Intent; 

import android. os. Bundle; 

import android. provider.Settings; 

import android. location.Criteria; 

import android. location. Location; 

import android. location. LocationListener; 
import android. location. LocationManager; 
import android. widget. EditText; 

import android. widget. Toast; 


public class LocationDemoActivity extends Activity { 


LocationManager lm; // 声 明 LocationManager 对 象 的 引用 
EditText et; // 声 明 EditText 对 象 的 引用 
LocationListener llistener = new LocationListener(){ // 声 明 一 个 LocationListener 对 象 
@Override 
public void onLocationChanged(Location location) {// 重 写 onLocationChanged( ) 方 法 
updateView(location); 
} 
@Override 
public void onProviderDisabled(String provider) ( // 重 写 onProviderDisabled() 方 法 
updateView(null); 
) 
@Override 
public void onProviderEnabled(String provider) ( // 重 写 onProviderEnabled( ) 方 法 
Location 1 = lm. getLastKnownLocation( provider); // 获 取 位 置信 息 
updateView(1); // 更 新 EditText 控件 的 内 容 
) 
@Override 
public void onStatusChanged( String provider, int status, Bundle extras) { 
// 重 写 onStatusChanged( ) Jj 1& 
) 
h 
@Override 


public void onCreate(Bundle savedInstanceState) ( // 重 写 onCreate() 方 法 
super. onCreate(savedInstanceState); 


setContentView(R. layout. main); // 设 置 当 前 屏幕 

et = (EditText)findViewById(R. id. et); // 获 得 EditText 对 象 
openGPSSettings(); // 调 用 打开 LocationManager() 方 法 ,并 判断 GPS 模块 是 否 开启 
getLocation(); // 调 用 获取 地 理 位 置信 息 方 法 


// 方 法 : 判断 GPS 模块 是 否 存在 或 者 是 开启 
private void openGPSSettings() ( 
LocationManager alm = (LocationManager) this 
-getSystemService(Context.LOCATION SERVICE); 
if (alm 
. isProviderEnabled(android. location.LocationManager. GPS PROVIDER)) { 
Toast.makeText(this, "GPS 模块 正常 "，Toast.LENGTH SHORT) 
. show() ; 
return; 
) 
Toast.makeText(this, "请 开启 GPS!", Toast. LENGTH SHORT).show(); 
Intent intent = new Intent(Settings. ACTION SECURITY SETTINGS); 
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58 startActivityForResult( intent, 0); // 此 为 设置 完成 后 返回 到 获取 界面 
59 $ 

60 // 方 法 : 获取 到 地 理 位 置信 息 

61 private void getLocation() 

62 { 

63 /* 获取 位 置 管理 服务 * / 

64 LocationManager lm = (LocationManager) this. getSystemService(Context. LOCATION SERVICE); 
65 String provider = lm.getBestProvider(getCriteria(), true); // 获 取 GPS 信息 
66 Location location = lm.getLastKnownLocation(provider); // 通 过 GPS 获取 位 置 
67 updateView(location); // 更 新 EditText 控件 的 内 容 

68 /* 设置 监听 器 , 自动 更 新 的 最 小 时 间 为 间隔 N 秒 (1 秒 为 1 * 1000, 这 样 写 主 要 为 了 方便 ) 
69 * 和 最 小 位 移 变化 超过 10 米 * / 

70 lm.requestLocationUpdates(provider, 5 * 1000, 10, llistener); 

71 } 

72 // 方 法 : 返回 查询 条 件 

73 public Criteria getCriteria()( 

74 Criteriac = new Criteria(); 

75 c. sethccuracy(Criteria. ACCURACY FINE); // 设 置 查询 精度 为 高 精度 

76 c. setSpeedRequired(false); // 设 置 是 否 要 求 速度 

77 c. setCostAllowed(false); // 设 置 是 否 允 许 产生 费用 

78 c. setBear ingRequired(false); // 设 置 是 否 需 要 得 到 方向 

79 c. setAltitudeRequired( false); // 设 置 是 否 需 要 得 到 海拔 高 度 

80 c. setPowerRequirement(Criteria.POWER LOW); // 设 置 允许 的 电池 消耗 级 别 为 低 功 耗 
81 return c; // 返 回 查询 条 件 

82 


} 
83 // 方 法 : 更 新 EditText 中 显示 的 内 容 
84 public void updateView(Location newLocation)( 


85 if(newLocation !- null)( // 判 断 是 否 为 空 

86 et. setText(" 您 现在 的 位 置 是 \n 18 HE : "); 

87 et. append(String. valueOf (newLocation. getLongitude( ) ) ) ; // 获 得 精度 
88 et.append("\n 4 E : "); 

89 et. append(String. valueOf (newLocation. getLatitude())); // 获 得 纬度 
90 } 

91 else( // 如 果 传 人 的 Location 对 象 为 空 则 清空 EditText 

92 et. getEditableText(). clear(); // 清 空 EditText 对 象 

93 } 

94 } 

95 

96 } 


中 第 18 一 35 行 ,声明 并 创建 一 个 LocationListener 对 象 llistener, 在 其 中 重 写 了 
onLocationChangedO , onProviderDisabled () , onProviderEnabled () 和 onStatusChanged() 4 
在 方法 。 

四 第 42 行 调用 openGPSSettings() 方 法 ,该 方法 定义 在 第 47 一 59 行 。 其 中 创建 了 
LocationManager 对 象 alm ,指定 LocationProvider 类 型 为 GPS. PROVIDER. ,即使 用 GPS 定 


位 ; 并 判断 GPS 模块 是 否 开 启 。 第 57 行 ,使 用 了 Settings. ACTION _ SECURITY _ 


SETTINGS 创建 一 个 Intent 对 象 , 这 里 的 Settings 是 一 个 系统 属性 设置 类 , 它 位 于 android. 
provider 包 下 ,有 许多 的 系统 属性 都 是 在 Settings 应 用 当中 进行 设置 的 ,例如 GPS, WIFI, W 
牙 状态 .当前 本 机 语言 及 屏幕 亮度 等 一 些 相关 的 系统 属性 值 。 

© 第 43 行 调 用 getLocation() 方 法 ,该 方法 定义 在 第 61 一 71 行 。 其 中 第 65 行 是 通过 
Im. getBestProvider (getCriteria (), true) 获得 地 理 位 置信 息 的 提供 者 , Criteria 对 象 由 
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getCriteria( ) 方 法 得 到 。 第 66 行 通过 GPS 获取 地 理 位 置信 息 。 第 67 行将 所 得 信息 显示 在 
EditText 控件 中 。 第 70 行 设置 监听 器 ,定义 每 间隔 5s 或 每 移动 10m 执行 一 次 提取 经 纬度 
数据 。 

CD 确定 SDK 版 本 ,添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml, 将 minSdkVersion 的 
值 设 置 为 “8”, 添 加 网 络 访问 权限 。 在 默认 生成 的 AndroidManifest. xml X fF rh, H; — manifest 
标签 内 应 该 有 下 列 代码 : 


« uses - sdk android:minSdkVersion = "8" /> 
< uses - permission android:name = "android. permission. ACCESS FINE LOCATION" /> 


【运行 结果 】 在 Eclipse 中 启动 API Level 8 的 Android CLEES 
a 
模拟 器 ,然后 运行 MyLocation 项 目 。 如 果 没有 设置 模拟 器 的 “CC 让 


GPS 数据 ,运行 界面 没有 任何 位 置信 息 。 如 果 按 本 节 介绍 的 [EISSUER 


经 度 : 113.22999999999999 


方法 设置 了 模拟 器 的 GPS 的 经 纬度 数据 , 则 界面 显示 如 恬 汪 度 :23.169999999999998 
图 10-26 所 示 。 


10.4.2 Google Map 应 用 
图 10-26 显示 模拟 器 的 模拟 


Google Map 是 Google 公司 提供 的 电子 地 图 服务 ,包括 GPS 经 纬度 数据 
局 部 详细 的 卫星 照片 。 它 能 提供 以 下 三 种 视图 。 

CD 矢量 地 图 , 即 为 传统 地 图 。 这 类 地 图 可 提供 行政 辖区 和 交通 以 及 商业 信息 。 

(2) 卫星 照片 , 即 为 俯视 地 图 。 这 类 地 图 与 Google Earth 工具 软件 显示 的 卫星 照片 一 样 ， 
可 以 看 到 一 些 地 区 的 实景 ,如 世界 各 地 的 城市 街区 ,重要 基地 等 。 

(3) 地 形 视图 。 可 以 显示 地 形 和 等 高 线 的 地 图 。 

为 了 使 得 应 用 程序 的 地 图 功能 更 加 强大 ,Google 提供 一 个 Maps 外 部 函数 库 , 包 含 在 
com. google. android. maps 包 内 。 该 包 中 的 类 提供 有 内 置 的 下 载 、 泻 染 和 地 图 拼接 的 缓冲 ,以 
及 各 种 显示 选项 和 控制 。 其 中 其 关键 类 是 MapView, 它 是 ViewGroup 类 的 子 类 ,为 用 户 提 供 
所 有 必要 的 UI 元 素 以 控制 地 图 ,例如 当 MapView 获得 焦点 时 , 它 可 以 捕捉 按键 ,触摸 手势 ， 
自动 地 平移 和 缩放 地 图 等 。 

要 在 MapView 中 显示 Google 地 图 数据 ,必须 注册 Google Maps 服务 ,并 获得 一 个 Maps 
API Key。 


1. 申请 Map API Key 


要 在 MapView 组 件 中 显示 Google Maps 数据 ,就 必须 注册 一 个 Google Maps API Key. 
每 个 Maps API Key 是 唯一 与 一 个 特定 的 基于 MD5 指纹 的 证 书 联 系 在 一 起 的 ,并 且 申 请 
Android Map API Key 还 需要 一 个 Google 的 账号 。 如 果 没 有 Google 的 账号 可 以 先 上 google 
网 站 去 申请 一 个 账户 。 

在 开发 Google Map 服务 的 应 用 时 ,程序 员 必 须 先 申请 一 组 验证 过 的 Map API Key。 为 
了 能 顺利 地 申请 Android Map API Key, 又 必须 要 准备 一 个 Google 的 账号 和 系统 的 数字 证 书 
(Hl MD5 指纹 )。 申 请 Map API Key 的 过 程 如 下 。 

1) 申请 Google 账号 

TE IE 中 输入 Google 网 址 : http://www. google. com. hk/ ,然后 单 击 “ 登 录 ”, 按 照 提示 注 
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册 一 个 Google 的 账号 。 这 个 Google 账号 是 通用 的 ,可 以 用 来 注册 Map API Key。 请 记 住 申 
请 Google 账号 时 使 用 的 邮箱 和 Google 账号 密码 。 

2) 获取 Map API Key 

在 较 早 时 期 ,Google Maps API 是 免费 提供 的 。 如 果 应 用 程序 要 使 用 到 Google Map ,就 
必须 获取 一 个 Map API Key。 要 注册 一 个 Maps API Key, 需 要 提供 一 个 用 来 对 应 用 程序 进 
行 签名 的 证 书 的 MD5 指纹 。 从 2012 年 之 后 ,Google Maps API 不 再 免费 提供 , 当 用 户 调用 
Google Maps API 每 天 超过 一 定 限制 次 数 (目前 限定 于 25 000 次 ) 之 后 ,会 按照 超出 的 次 数 来 
收取 费用 ,费用 是 每 一 千 次 调用 0. 5 美元 左右 。 在 Google Maps API 实施 部 分 收费 之 后 ， 
Google 提供 了 APIs Console 进行 所 有 API 的 管理 ,但 仍 支持 使 用 Map API Key, 

(1) MD5 指纹 。 

MD5 的 全 称 是 message-digest algorithm 5, 即 信息 摘要 算法 ,被 广泛 用 于 加 密 和 解密 技 
术 上 , 它 又 称 为 文件 的 “数字 指纹 ”。 如 同人 的 指纹 一 样 , 任 何人 都 有 自己 独一无二 的 指纹 ,与 
之 类 似 , MD5 可 以 为 任何 文件 (不 管 其 大 小 格式、 数量 ) 产 生 一 个 同样 独一无二 的 “数字 指 
纹 ”, 如 果 任 何人 对 文件 做 了 任何 改动 ,其 MD5 值 也 就 是 对 应 的 “数字 指纹 ”都 会 发 生变 化 。 
要 注册 一 个 Maps API Key, 需 要 提供 一 个 用 来 对 应 用 程序 进行 签名 的 证 书 的 MD5 指纹 。 生 
成 MD5 指纹 的 操作 步骤 如 下 。 

首先 查看 Eclipse 中 的 Default debug keystore 的 路 径 。 选择 菜单 Window>Preferences, 
进入 Preferences 对 话 框 ,展开 左 侧 窗口 的 Android, Jit; Build 项 , 记 住 右 侧 窗口 中 的 Default 
debug keystore 的 路 径 , 如 图 10-27 所 示 。 


type fiter tet Build > 号 "= 
General Ape 
Bi [VI Automatically refresh Resources and Assets folder on build 
s E IV] Force error when external jars contain native libraries. 
md 国 skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch Build output. 
LogCat 9 Silent 
Usage Stats |E] | © Normal 
Ant © Verbose 
Data Management e 
ie Default debug PEU 2» 
» Instal/Update. Custom debug keystore: Browse.. 


Java 
Java EE 
Java Persistence 

» JavaScript 
Plug-in Development 
Remote Systems 


» Run/Debug 
ll 
© 


E 


Æl 10-27 Preferences 对 话 框 


然后 在 命令 行 状态 (运行 cmd 进入 命令 行 状 态 ) 下 ,使 用 JDK 自 带 的 keytool 工具 ,输入 
命令 : 


Keytool -list -alias androiddebugkey -keystore " C: \ Users V Administrator V. android V debug. 
keystore" -storepass android -keypass android 
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如 图 10-28 所 示 ,输入 完 此 命令 之 后 回 车 , 即 可 得 到 一 个 MD5 指纹 ,如 图 10-29 所 示 。 


20: En Dn :13: P5 98:6 


图 10-29 得 到 MD5 认证 指纹 


这 里 得 到 的 MD5 认证 指纹 为 1C: 7D: 3F: D9: AF :56:6B: 58: 2B: EA: DA 13: F5:9A; 
A6:D7:79:50:BF:47。 aum 不 同 的 应 用 程序 其 MD5 指纹 不 同 , 可 以 使 用 上 述 操作 方法 得 
到 自己 的 MD5 认证 指纹 。 这 个 MD5 认证 指纹 很 重要 ,一 个 应 用 程序 发 布 时 必须 要 有 MD5 
指纹 。 所 以 在 开发 时 要 将 自己 的 MD5 指纹 妥善 保管 好 。 

(2) 申请 Map API Key 方式 。 

从 2012 年 2 月 开始 ,Google 变更 了 其 Maps API 的 申请 方式 ,不 再 提供 以 前 的 申请 API 
Key 方 式 。 下 面 介绍 新 的 Map API Key 申请 方式 。 

在 浏览 器 的 地 址 栏 中 输入 如 下 网 址 ;https://code. google. com/apis/console. 使 用 
Google 账号 登入 APIs Console, 如 图 10-30 所 示 。 


Google apis 


Start using the Google APIs console 


!o manage your API usage 
i 
m 
3 an APIs project w 
; Use Google APIs beyond anonymous limits. 
* Monitor API usage and control AP! acces: 
~ Share Aj 


图 10-30 Google APIs console 的 进入 界面 
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Ht Create project... 按 钮 ,进入 下 一 页 面 ,在 左 侧 的 API Project 下 单 击 Servers. ff fll 


窗口 显示 所 有 的 Servers 列表 。 向 下 找到 Google Maps API v2 项 ,将 其 Status CR SO EHE 
On, 如 图 10-31 所 示 。 


Courtesy imit 100,000 requests/day 


LJ 
LJ 

RI Fusion Tables API e e Courtesy imit 25,000 requestsiday 
9 


X Google Affiliate Network API Courtesy limit: 1,000 requests/day 
RI Google Cloud Messaging tor Androia 伟 

X! Google Cloud SQL. LJ 

19 Googie Cloud Storage. eror Pricing 

1P Googie Cloud Storage JSON API Courtesy limit: 100,000 requestsiday 
8 Google Compute Engine. 


D Google Maps API v2 Courtesy imit: 25,000 
requestsiday * Pricing 


Courtesy imit: 25,000. 
requestsiday * Pricing 


Courtesy imit 1,000 requests/day 


10-31 Xf API Project 的 Servers 列表 项 的 状态 设置 


在 左 侧 的 API Project 下 单 击 API Access ,在 右 侧 窗口 单 击 Create new Browser key... 
然后 填 入 要 生成 Key 的 网 址 , 单 击 Create 按钮 , 即 可 得 到 一 个 API Key, 如 图 10-32 所 示 。 如 
果 已 经 有 一 个 旧 的 Key, 可 以 单 击 右 侧 的 Generate new key... 生 成 新 的 API Key. 


ES -— bd —À cmd 


API Access 
To prevent abuse, Google places imis on AP! requests. Using a valid OAuth token or API key allows you to exceed 
anonymous lmis by connecting requests back to your project 


Authorized API Access. 
OAuth 2 0 allows users to share specific data with you (for example, 


contact ls) whie keeping their usemames, passwords, and other 
information private. A single project may contain up to 7 client IDs. 


Leam moe 
Create an OAuth 2.0 client ID... 
Simple API Access 


Use API keys to identify your project when you do not need to access user data. Leam more 


Key for browser apps (with referers) Generate new key 
API key: AIsaSyDfGHetp YAéaUyApOBeXipoja]fOblzxA PRU. 


Referers: Any referor allowed Detete key. 
Actvatedon: — Jul31 2012 1255 AM 
ActNaledby. — indzh@163 com - you 


Create new Server key...| Create new Browser key... 


Code Home - Privacy Polk 


图 10-32 生成 API Key 


3) 复制 Map API Key 
通常 在 应 用 Google Map 的 Activity 中 ,其 布局 文件 要 定义 一 个 “MapView”, 并 且 在 该 标 
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签 的 属性 android:apiKey 中 要 求 有 API key, 这 也 就 是 获取 的 Map API Key. 
将 获取 的 地 图 API 密 钥 Map API Key 复制 到 main. xml 布局 文件 的 MapView 标签 中 ， 
代码 如 下 。 
< com. google. android. maps. MapView 
android:layout width- "fill parent" 
android:layout height = "fill parent" 


android:apiKey - "AizaSyDf8Hstp Y46aVyApDBzXipojajfOblJXA" 
/> 


注意 ,如 果 apiKey 不 正确 ,模拟 器 则 无 法 加 载 地 图 ,只 会 出 现 网 格 效果 。 
2. 创建 支持 Google Map 的 模拟 器 


Google 地 图 并 不 是 标准 Android 类 库 ,并 不 是 所 有 的 Android 设备 都 支持 该 功能 。 所 以 
运行 Google 地 图 应 用 程序 ,需要 创建 一 个 能 支持 Google API 设备 的 模拟 器 。 也 就 是 说 ,在 模 
拟 器 创建 期 间 ,选择 SDK 的 版 本 时 ,在 选择 目标 (Target) 选 项 时 要 选择 Google APIsCGoogle 
Inc. ) ,如 图 10-33 所 示 。 


grece o NN 


Name: — VD Google-23 
ABE [ARM (armeabi) - i E 
SD Card: 
Sizes 1024 — [we - 
Ofle: | | [Browse.. 
Snapshot: 
FiEnabled. 
Skin: 
© Buki — [HvGA ~ 
DResoutior| Jf 


图 10-33 ”创建 模拟 器 


3. 向 AndroidManifest. xml 文件 中 添加 相关 内 容 


在 使 用 Google Maps 的 应 用 程序 中 ,需要 手动 在 AndroidManifest. xml. 文件 的 
—application > s 4€ Vj 8 JI Till F ff — uses-library > b 4 o 


< uses - library android: required = "true" android: name = "com. google. android. maps"? «/uses — 
library» 


使 用 Google Maps 还 要 求 对 Internet. 的 访问 权限 ,因为 需要 从 Internet. 上 读 取 Google 
Maps 数据 。 所 以 要 在 AndroidManifest. xml X (f fj — manifest ^ bi 4& P3 S JI Vi [e] Pd Z6 BC DR. 


< uses - permission android:name = "android. permission. INTERNET" /> 
4. Google Map 应 用 编程 


Android 的 Google Map 应 用 的 关键 类 是 MapView, MapView 位 于 com. google. android. 
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maps 包 下 ,MapView 是 显示 一 幅 带 有 Google 地 图 数据 的 控件 ,能 捕捉 按键 事件 和 触摸 手势 ， 
以 实现 地 图 缩放 功能 ,是 Google 地 图 API 的 一 个 缩 略 版 。MapView 通过 Overlay 类 控制 
地 图 。 

使 用 MapView 对 象 调 用 getController() 方 法 可 以 获得 一 个 MapController 对 象 。 通 过 
MapController 对 象 可 以 对 MapView 对 象 中 的 地 图 进行 缩放 。 常 用 的 方法 如 表 10-5 所 示 。 


表 10-5 MapController 对 象 的 几 个 方法 及 说 明 


方 法 do g 
zoomInO 缩小 一 个 等 级 
zoomOut() 放大 一 个 等 级 
setZoom(int zoomLevel) 直接 设置 缩放 等 级 ,zoomLevel 取 值 范围 为 1 一 21 
animateTo(GeoPoint point) 平滑 移动 地 图 视图 到 指定 点 。 通 过 point 来 指定 要 移动 的 目标 地 点 , 同 
时 还 可 选 在 到 达 目 的 地 后 运行 一 个 Runable 对 象 ,或 发 送 一 条 Message 
setCenter(GeoPoint point) 移动 视图 到 point 指定 的 位 置 ,没有 平滑 移动 的 效果 


下 面 通过 一 个 案例 来 说 明 Google Map 的 应 用 。 

【案例 10.7】 以 交通 地 图 .卫星 地 图 两 种 方式 查询 指定 经 纬度 坐标 的 地 理 位 置 ,并 用 箭 
头 图 标定 位 该 点 ,并 允许 用 户 缩放 地 图 ,移动 地 图 。 

【说 明 】 本 例 是 Google 地 图 的 应 用 ,事先 应 创建 一 个 Target 为 Google APIs 的 模拟 器 
设置 。 

【开发 步骤 及 解析 】 

(1) 获取 一 个 Map API Key 值 。 获 取 方 法 前 面 已 经 有 详细 描述 。 

(2) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 MyGoogleMap 的 Android 项 目 。 其 应 用 程序 
名 为 MyGoogleMap ,选择 Build Target 时 色 选 Google APIs. Platform 为 2. 3. 1, 包 名 为 cn. 
com. sgmsc. GMap Activity 组 件 名 为 MyGoogleMapActivity。 

(3) 准备 图 片 资 源 。 在 drawable-mdpi 下 存放 图 标 文 件 arrow. png。 

CD 准备 字符 串 资 源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 

1 <?xml version="1.0" encoding= "utf - 8"?> 


2 «resources» 
3 < string name = "hello"> Hello World, MyGoogleMap!«/string» 


4 < string name = "app name" MyGoogleMap «/string? 

5 < string name = "txtLong"> 经 度 : «/string» <! -- 声明 名 为 txtLong 的 字符 串 资源 --> 
6 < string name = "txtLat"> 纬 度 : </string> <! -- 声明 名 为 txtLat 的 字符 串 资源 --> 
? < string name = "btnGo"> 查 询 </string> <! -- 声明 名 为 btnGo 的 字符 串 资源 --> 
8 «string name = "etLong"> 113.32 </string> <! -- 声明 名 为 etLong 的 字符 串 资 源 --> 
9 «string name = "etLat"> 23.136 </string> ”<! -- 声明 名 为 etLat 的 字符 串 资源 --> 


10 < string name = "satellite"> 卫 星 视 图 </string> ”<! -- 声明 名 为 satellite 的 字符 串 资源 --> 
11 «string name = "normal"> 普 通 视 图 </string> <! -- 声明 名 为 normal 的 字符 串 资 源 --> 


12 </resources > 

第 8.9 行 给 出 程序 的 初始 经 度 、 纬 度数 据 。 

(5) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 
1 <?xml version- "1.0" encoding = "utf - 8"?> 


2  «LinearLlayout xmlns:android = "http: //schemas. android. con/apk/res/android" 
3 android:orientation- "vertical" 
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NS 


android:layout width- "fill parent" 
android:layout height = "fill parent" 
> 
< LinearLayout 
android:orientation = "horizontal" 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
t. 
< TextView 
android: text = "(3 string/txtLong" 
android: layout_width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
/> 
< EditText 
android: id= "(9 + id/etLong" 
android: text = "@string/etLong" 
android: layout_width = "110px" 
android:layout height = "45px" 
/> 
< TextView 
android:text = "(9 string/txtLat" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android: paddingLeft = "8px" 
^ 
< EditText 
android: id= "(9 + id/etLat" 
android:text = "(9 string/etLat" 
android:layout width = "110px" 
android:layout height = "45px" 
/> 
</LinearLayout > 


< LinearLayout 


android:orientation = "horizontal" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
> 
< RadioGroup 
android: id= "@ + id/rg" 
android:orientation = "horizontal" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout marginRight = "6dip" 
> 
< RadioButton 
android: text = "@string/normal" 
android: id= "(9 + id/normal" 
android:checked = "true" 
android:layout width- "wrap content" 


android:layout height = "wrap content"? 


«/RadioButton» 
< RadioButton 
android: text = "@string/satellite" 
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android:id- "(9 + id/satellite" 
android:layout width = "wrap content" 
android:layout height = "wrap content"» 
«/RadioButton? 

«/RadioGroup? 

« Button 

android: id= "(9 + id/btnGo" 

android: text = "(àstring/btnGo" 

android:layout width- "wrap content" 

android:layout height = "wrap content" 

android:layout marginRight = "6dip" 

android:layout weight - "1" 

/> 

</LinearLayout > 
< com. google. android. maps. MapView 

android: id= "(9 + id/mv" 

android:clickable = "true" 

android:enabled = "true" 

android:layout width- "fill parent" 

android:layout height = "fill parent" 

android:apiKey = " AizaSyDf8Hstp Y46aVyApDBzXipojajfOblJXA " 

人 > 

</LinearLayout > 


(D 第 73 一 80 行 定义 了 该 应 用 的 Google 地 图 的 显示 控件 MapView, 因 为 它 是 外 部 控件 ， 
所 以 需要 在 前 面 加 上 com. google. android. maps 包 名 。 

© 第 79 行 是 Map API Key 属性 ,需要 输入 一 串 Google 的 Map API Key 值 。 只 有 获取 
正确 的 Map API Key 值 才 能 正常 显示 Google 地 图 。 

(6) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. GMap 包 下 的 MyGoogleMapActivity. java 
文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. GMap; 
import java. util. List; 


import android. graphics. Bitmap; 

import android. graphics. BitmapFactory; 

import android. os. Bundle; 

import android. view. View; 

import android. widget. Button; 

import android. widget. EditText; 

import android. widget. RadioButton; 

import android. widget. RadioGroup; 

import android. widget. Toast; 

import android. widget. RadioGroup. OnCheckedChangeListener; 


import com. google. android. maps. GeoPoint; 
import com. google. android. maps. MapActivity; 
import com. google. android. maps. MapController; 
import com. google. android. maps. MapView; 
import com. google. android. maps. Overlay; 


public class MyGoogleMapActivity extends MapActivity { // 继 承 自 Maphctivity 的 子 类 
MapView mv; // 声 明 MapView 对 象 引 用 
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MapController controller; // 8} MapController 对 象 引 用 
Bitmap bmpArrow; // 声 明 Bitmap 对 象 引 用 
RadioButton rbNormal; // 声 明 RadioButton X4 $ 5| JH 
RadioButton rbSatellite; // 声 明 RadioButton X4 $ 5| JH 
(QOverride 

protected void onCreate(Bundle icicle) { //3& 8 onCreate() Jr ik 


super. onCreate( icicle); 
setContentView(R. layout. main); 
bmpArrow = BitmapFactory.decodeResource(getResources(), R. drawable. arrow) ; 


// 获 得 “箭头 "图片 
Button btnGo = (Button)findViewById(R. id.btnGo); // 获 得 Button 对 象 
mv = (MapView)findViewById(R. id. mv); // 获 得 MapView 对 象 
controller = mv.getController(); // 获 得 MapController 对 象 
mv. setBuiltInZoomControls(true); // 设 置 是 否 显示 “放大 /缩小 ”按钮 
mv. setSatellite(false); // 设 置 不 显示 卫星 模式 地 图 
mv. setStreetView(false); // 设 置 不 显示 街景 模式 地 图 
mv. setTraffic(true); // 设 置 显示 交通 模式 地 图 


btnGo. setOnClickListener(new View. OnClickListener() { 
public void onClick(View v) { 
EditText etLong = (EditText)findViewById(R. id.etLong); // 获 得 EditText 对 象 
EditText etLat = (EditText)findViewById(R. id.etLat);  // 获 得 EditText 对 象 
String sLong = etLong. getEditableText().toString().trim();  // 获 得 输入 的 经 度 
String sLat = etLat. getEditableText().toString().trim(); // 获 得 输入 的 纬度 
if(sLong.equals("") || sLat.equals(""))( // 判 断 是 否 输入 空 值 
Toast. makeText (MyGoogleMapActivity. this, "对 不 起 , 请 输入 正确 的 经 纬度 
AUS, 
Toast.LENGTH LONG). show() ; 
return; 
) 
double dLong = Double. parseDouble(sLong); 
double dLat = Double. parseDouble(sLat); 
updateMapView(dLat, dLong); // 调 用 方法 更 新 MapView 
) 
Di 
btnGo. perfornClick(); 
// 生 成 一 个 单 击 按钮 的 事件 , 即 相当 于 单 击 了 一 下 按钮 


RadioGroup rg = (RadioGroup)findViewById(R. id. rg) ;// 获 得 RadioGroup 对 象 
rbNormal = (RadioButton)findViewById(R.id.normal); // 获 得 RadioButton 对 象 
rbSatellite = (RadioButton)findViewById(R. id. satellite); // 获 得 RadioButton 对 象 
rg. setOnCheckedChangeListener(new OnCheckedChangeListener() ( 
public void onCheckedChanged(RadioGroup group, int checkedId) ( 
if(checkedld == rbNormal. getId()){ // 判 断 按 下 的 是 否 是 正常 视图 
mv. setSatellite(false); 
mv. setStreetView(false); 
nv. setTraffic(true); 
} 
else if(checkedId == rbSatellite.getId())( // 判 断 按 下 的 是 否 为 卫星 视图 
mv. setSatellite(true); 
mv. setStreetView(false); 
mv. setTraffic(false); 
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78 (ZOverride 


79 protected boolean isRouteDisplayed() { // 重 写 isRouteDisplayed() 方 法 
80 return false; // 不 需要 在 地 图 上 绘制 导航 线路 
81 


} 
82 // 方 法 :更 新 MapView 的 视图 
83 public void updateMapView(double dLat, double dLong){ 


84 GeoPoint gp = new GeoPoint((int)(dLat * 1E6), (int)(dLong* 1E6)); 

85 mv. displayZoomControls(true); // 设 置 显示 “放大 /缩小 ”按钮 

86 controller. animateTo( gp); // 将 地 图 移动 到 指定 的 地 理 位 置 
87 List< Overlay> ol = mv.getOverlays(); // 获 得 MapView 的 Overlay 列表 
88 ol.clear(); 

89 ol. add(new FixOverLay(gp, bmpArrow)); // 添 加 一 个 新 的 Overlay 

90 } 

91 } 


(D 58 37—39 行 , 设 置地 图 的 显示 类 型 。 

© 第 54 行 调用 updateMapView(dLat, dLong) 方 法 更 新 MapView 中 的 地 图 。 

© 第 57 行 调 用 btnGo. performClick( ) 方 法 ,该 方法 是 由 程序 控制 执行 按钮 的 单 击 事件 ， 
不 需要 用 户 操作 。 

© 第 62—75 行 定 义 了 单 选 按钮 的 监听 器 。 在 该 监听 的 回调 方法 内 定义 了 当 用 户 选 择 哪 
一 种 地 图 的 显示 方式 时 ,就 在 MapView 中 显示 相应 的 地 图 类 型 。 

© 第 83 一 90 行 ,定义 updateMapView() 方 法 。 在 其 中 第 84 行 定义 一 对 经 纬度 数据 ， 
GeoPoint 类 位 于 com. google. android. maps 包 下 ,以 纬度 的 整数 形式 存储 ,表示 一 对 经 、 纬 度 
值 ，GeoPoint 对 象 构造 后 不 可 再 修改 经 、 纬 度 值 ,但 可 返回 该 对 象 。 第 88 行 删除 地 图 上 的 原 
AAM. B 89 行 添加 一 个 新 的 Overlay 覆盖 ,并 调用 FixOverLay 类 来 标记 位 置 图 标 ,这 里 
gp 为 经 ,纬度 坐标 点 ,bmpArrow 为 显示 的 图 标 对 象 。Overlay, 即 覆盖 ,可 将 它 理 解 成 一 块 透明 
的 画布 ,将 它 铺 在 地 图 上 。Overlay 类 可 以 进行 的 操作 主要 有 两 项 : 绘制 (标记 ) 和 处 理 触 摸 事件 。 

(7) 开发 在 地 图 上 标记 位 置 图 标的 代码 。 

若 要 在 地 图 上 标记 位 置 ,就 需要 用 到 Overlay 类 。Overlay 类 是 一 种 专门 用 于 在 地 图 上 用 
2D 图 像 进行 标记 的 类 。 巾 于 其 默认 的 绘制 方法 draw() 并 不 绘制 任何 图 像 ,所 以 通常 会 开发 
一 个 OverLay 的 子 类 ,并 添加 到 MapView 的 OverLay 列表 中 。 

在 src/cn. com. sgmsc. Gmap 包 下 创建 一 个 代码 文件 FixOverLay. java, 该 文件 是 定义 一 
个 OverLay 子 类 ,用 于 在 地 图 上 标记 当前 位 置 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. GMap; // 声 明 包 语句 


1 

2 

3 import android. graphics. Bitmap; 

4 import android. graphics. Canvas; 

5 import android. graphics. Point; 

6 import com. google. android. maps. GeoPoint; 

7 import com. google. android. maps. MapView; 

8 import com. google. android. maps. Overlay; 

9 import com. google. android. maps. Projection; 


10 

11 public class FixOverLay extends Overlay( 

12 Bitmap bmpArrow; // 声 明 Bitmap 对 象 的 引用 
13 GeoPoint gp; // 声 明 GeoPoint 对 象 的 引用 
14 public FixOverLay(GeoPoint gp, Bitmap bmp)í 

15 super(); // 调 用 父 类 构造 器 


16 this.gp = gp; // 初 始 化 GeoPoint 
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17 bmpArrow = bmp; // 初 始 化 Bitmap 
18 ] 

19 (ZOverride 

20 public void draw(Canvas canvas, MapView mapView, boolean shadow) ( 


21 if(!shadow)( 

22 Projection proj = mapView.getProjection(); // 获 得 Projection 对 象 
23 Point p = new Point(); 

24 proj.toPixels(gp, p); // 将 真实 地 理 坐标 转化 为 屏幕 上 的 坐标 
25 canvas. drawBitmap(bmpArrow, 

26 p. x- bnphrrow. getWidth()/2, 

27 p. y- bmpArrow.getHeight(), 

28 null); // 绘 制 箭头 图 片 

29 } 

30 } 

a} 


(D 第 20 一 30 FEST draw() 方 法 。 该 方法 有 三 个 参数 : 参数 canvas, 就 是 所 要 绘制 其 
上 的 画布 ; 参数 mapView, 所 需 标 记 的 地 图 图 层 , 这 个 参数 的 一 个 重要 作用 就 是 通过 
MapView. getProjection() 得 到 一 个 Projection 对 象 , 它 完成 从 物理 经 纬度 到 屏幕 投影 坐标 的 
转换 ,继而 在 相应 坐标 点 上 进行 绘制 ; 参数 shadow , 当 该 值 为 true 时 , 则 需 绘 制 阴影 图 层 , 若 
为 false, 则 只 需 绘制 本 来 的 内 容 即 可 。 

Q) 第 25 一 28 行 完成 一 个 图 标 在 指定 坐标 上 的 绘制 。 

(8) 添加 标签 和 权限 。 打 开 根 目录 下 的 AndroidManifest. xml. < manifest > fj && V3 s 
加 下 列 权限 ,代码 为 ， 


< uses - permission android:name = "android. permission. INTERNET" /> 
在 AndroidManifest. xml 文件 的 二 application 二 标签 内 添加 过 uses-library 二 标签 ; 


< uses - library android: required = "true" android: name = "com. google. android. maps"></uses — 

library» 

【运行 结果 】 在 Eclipse 中 启动 Google APIs 的 Android 模拟 器 ,然后 运行 MyGoogleMap 项 
目 。 在 界面 上 显示 预 设置 经 纬度 的 普通 视图 ,如 图 10-34 所 示 , 如 果 单 击 “ 卫 星 视图 ” 单 选 按 
钮 , 则 显示 如 图 10-35 所 示 的 卫星 地 图 。 


& wi d 5:06 


'MyGoogleMap MyGoogleMap 
113.32 


e) 苦 通 视图 


图 10-34 指向 广州 市 天 河 城 的 普通 视图 图 10-35 指向 广州 市 天 河 城 的 卫星 视图 
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(0.5 应 用 项 目 签名 与 打包 


如 果 要 将 自己 开发 的 Android 项 目 发 布 应 用 ,就 必须 为 自己 的 应 用 程序 项 目 打包 和 签名 ， 
将 打包 签名 后 的 apk 文件 传人 Android 模拟 器 或 Android 手机 中 即 可 安装 运行 。 


10.5.1 Android 应 用 项 目的 签名 文件 


为 什么 要 对 应 用 程序 项 目 进行 签名 呢 ? 这 是 因为 全 世界 开发 Android 项 目的 人 很 多 ,在 
项 目 中 的 包 和 各 个 类 的 命名 方面 ,完全 有 可 能 大 家 都 使 用 了 相同 的 名 字 , 这 时 候 如 何 区 分 ? 签 
名 就 起 着 区 分 的 作用 。Android 签名 是 发 送 者 的 身份 认证 ,是 保证 信息 传输 的 完整 性 的 一 种 
手段 ,是 Android Market 对 软件 的 要 求 , 它 可 以 防止 交易 中 抵赖 事情 的 发 生 。 


1. 关于 Android 签名 


在 为 Android 应 用 程序 项 目 签名 时 ,需要 注意 以 下 几 点 。 

(1) 所 有 的 Android 应 用 都 必须 有 数字 签名 ,没有 不 存在 数字 签名 的 应 用 ,包括 模拟 器 上 
运行 的 。Android 系统 不 会 安装 没有 数字 证 书 的 应 用 。 

(2) 同一 个 开发 者 的 多 个 应 用 程序 项 目 尽 可 能 使 用 同一 个 数字 证 书签 名 ,这 样 做 有 利于 
程序 升级 ,有 利于 程序 的 模块 化 设计 和 开发 ,可 以 通过 权限 (permission) 的 方式 在 多 个 程序 间 
共享 数据 和 代码 。 

(3) 签名 的 数字 证 书 不 需要 权威 机 构 来 认证 ,是 开发 者 自己 产生 的 数字 证 书 , 即 所 谓 的 自 
签名 。 

(4) 正式 发 布 一 个 Android 应 用 时 ,必须 使 用 一 个 合适 的 私 钥 生成 的 数字 证 书 来 给 程序 
签名 ,不 能 使 用 ADT 插件 或 者 ANT 工具 生成 的 调试 证 书 来 发 布 。 

(5) 数字 证 书 都 是 有 有 效 期 的 ,Android 只 是 在 应 用 程序 项 目 安装 的 时 候 才 会 检查 证 书 
的 有 效 期 。 如 果 程 序 已 经 安装 在 系统 中 ,即使 证 书 过 期 也 不 会 影响 程序 的 正常 功能 。 


2. 生成 签名 文件 


在 Android 中 生成 签名 文件 有 两 种 方式 : 一 是 使 用 命令 行 状态 下 的 命令 方式 ,二 是 使 用 
ADT 插件 方式 。 注 意 : 在 生成 签名 文件 时 ,保存 签名 文件 的 文件 夹 必须 事先 建立 ,生成 签名 
文件 过 程 中 不 会 自动 创建 文件 夹 。 

1) 使 用 命令 行 方式 

如 果 在 Windows 操作 系统 的 系统 环境 变量 path 中 加 入 “C:\Program Files\Java\jdk1. 
7.0_05\bin” 路 径 , 那 么 使 用 cmd 命令 进入 命令 行 状态 后 ,先进 入 保存 签名 文件 的 文件 夹 中 
(使 用 CD 二 文件 夹 名 二 ) ,再 输入 命令 (如 图 10-36 所 示 ): 


Keytool -genkey -alias lindand. keystore -keyalg RSA -validity 20000 -keystore lindand. keystore 


图 10-36 在 命令 行 状态 下 输入 生成 签名 文件 命令 
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在 输入 完 上 述 命令 , 按 回 车 键 之 后 ,系统 会 给 出 一 系列 的 问题 。 根 据 屏幕 上 的 提示 逐一 回 
B ,形成 签名 文件 ,签名 文件 的 扩展 名 为 . keystore, 如 图 10-37 Bros; 


— — i 
TES CAWindows system32Vcmd exe = 


(— 


iblic)keytool -genkey -alias lindand.keystore -keyalg RSA -validity 20008 
store 


sc.com.cn, O-Jgms, L-GuangZhou, ST-GuangDong, C*cn 


Hii A Xlindand 


E: nypublic>, 


图 10-37 ”在 命令 行 状态 下 输入 生成 签名 文件 命令 


其 中 ,lindand. keystore 为 签名 文件 的 文件 名 .E:\ 中 的 mypublic 为 保存 lindand. keystore 
的 文件 夹 ; -validity 20000 为 证 书 的 有 效 天 数 。 另 外 ,在 输入 密码 时 是 不 能 回 显 的 ,所 以 输入 
时 既 看 不 到 任何 光标 移动 ,也 看 不 到 输入 了 符号 ,这 个 密码 在 给 . apk 文件 签名 的 时 候 需 要 。 

2) 使 用 ADT 插件 方式 

首先 在 Eclipse 中 选择 需要 发 布 的 项 目 , 然 后 右 击 ,在 弹出 菜单 中 依次 选择 Android Tools > 
照 打 包 并 生成 签名 文件 向 导 的 提示 逐一 完成 
生成 签名 文件 。 具 体操 作 步 骤 将 在 10. 5. 2 节 中 详细 介绍 。 


10.5.2 Android 应 用 项 目的 打包 
1. ADT 自动 生成 的 apk 


Export Signed Application Packge... . 


在 Eclipse 中 创建 的 Android 应 用 项 目 要 运行 在 手机 上 ,必须 要 先 打 包 再 安装 。Android 
应 用 项 目 打包 即 为 生成 apk 文件 ， P Android Package) 4& Android 的 安装 包 , 它 包含 应 用 项 
的 二 进 制 代码 ,资源 .配置 文件 等 。 每 个 要 安装 到 Android 平台 的 应 用 项 目 都 要 被 编译 打包 

-个 单独 的 . apk 文件 。 实 际 上 ， 在 Eclipse 中 创建 应 用 项 目 并 运行 的 过 程 就 是 : 编译 一 打 
> 安装 一 运行 。 经 过 编译 之 后 在 项 目的 bin 目录 下 会 自动 生成 一 个 apk 文件 。 与 J]2ME 不 
同 , 无 须 手动 打包 ,而 且 如 果 代码 有 改动 就 自动 build, 生 成 新 的 apk 文件 。 

这 个 过 程 是 通过 Eclipse 的 ADT 插件 自动 完成 的 ,并 不 适合 发 布 应 用 项 目 。Android 应 
用 程序 打包 必须 要 通过 一 个 证 书 文件 进行 加 密 , 而 在 调试 时 之 所 以 也 能 打包 ,是 因为 Eclipse 
在 安装 ADT 插件 的 时 候 创建 了 一 个 keystore 证 书 文件 。 它 的 位 置 可 以 通过 依次 选择 Eclipse 
的 菜单 Window Preferences Android Build 下 面 找到 ,如 10. 4. 2 节 中 的 图 10-27 所 示 。 


2. 发 布 应 用 使 用 的 apk 


如 果 要 发 布 Android 应 用 项 目 , 打 包 必 须要 通过 一 个 证 书 文件 进行 加 密 。 这 样 的 打包 文 
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件 生成 步骤 如 下 。 

CD 在 Eclipse 中 ,选择 需要 发 布 的 项 目 , 然 后 右 击 ,弹出 菜单 ; 在 弹出 菜单 中 选择 
Android Tools>Export Signed Application Package... ,该 选项 是 完成 打包 并 同时 生成 签名 文 
件 操作 ,或 选择 Android Tools Export UnSigned Application Package... ,该 选项 是 完成 打包 
但 不 生成 签名 文件 操作 ,如 图 10-38 所 示 。 


M 4———— AT BG SORS (false): 
: 号 MaGoogisMep eese die AtShifttDown [zoomconcrols (true); 
» E MyLocation D 
4 $9 MyMap Source Al+Shift+s» 
asr ES Akeskero |f the position on the map. "/ 
2l enge] Locarion() ( 
> @ Mj a. Import. onoverlay overlay = new MyLocationOverl 
orn Location (): 
BÀ Googl eu hecompass (); // does not work in emulat 
» B gen [Generd o Refresh ps [irstFix new Runnable () ( 
D assets " 
» B res risa 
B Android Cose Unrelated Projects 
default.prop Assign Working Sets... 
b $$ PhotoCapture£| Run As 
? 8S PicCamera PRESE 
b E$ ResultData. Profle As 
b 9 Sample 10.2 $ 
b i Sample 10.3 E 
> t Sample 10.4 en 
^l) Sample 13.5 Compare With 
^ $3 Sample.15.1 Restore from Local History.. 
七 Sample 15 2 Android Tools. 


图 10-38 选择 打包 菜单 项 


这 里 以 选择 Export Signed Application Package... 为 例 ,说 明 打 包 并 生成 签名 文件 的 过 
程 。 单 击 Export Signed Application Package... 项 ,进入 Export Android Application (输出 
Android 应 用 ) 向 导 页 ,如 图 10-39 所 示 。 

(2) 单 击 Next 按钮 进入 签名 文件 的 定义 页 。 在 此 页 ,选择 Create new keystore 项 表示 是 
新 创建 签名 文件 ,定义 签名 文件 的 文件 名 、 所 在 路 径 、 密 码 等 信息 ,如 图 10-40 所 示 。 


Project Checks 
Performs a set of checks to make sure the application can be exported. 


Keystore selection 
中 


© Use existing keystore 
@ Create new keystore 
Locator: eAmypublic\keystore\lindand.keystore Browse... 


Select the project to export: 


Project: MyGoogleMap 


[9] EZATT Frish | mm | © sec Nemo.) Frish | [eene 
图 10-39 Export Android Application 的 选择 项 目 页 图 10-40 ”创建 签名 文件 的 定义 页 


G) S; Next 按钮 进入 生成 签名 文件 信息 页 。 在 此 页 ,输入 签名 文件 名 、 密 码 、 有 效 时 间 
(以 年 为 单位 ), 以 及 签名 者 的 相关 信息 等 ,如 图 10-41 所 示 。 
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径 。 0-42 所 示 。 
Export An 23 
Key Creation e Destination and key/certificate checks [2] 
| 
Alias: lindand keystore Destination APK file: emypublicmygooglemap.apid Browse... 


Password: Em 
Certificate expires in 200 years. 


Confirm: Em 
Validity (years): 200 
First and Last Name: LindaZh 
Organizational Unit sgmsc.com.en 
Organization: 3gms 

City or Locality ^ — Guangzhou 


State or Province: ^ GuangDong 


Country Code 000: (cn 


[o] ETIN NECS Finish Caneel | @ rr Nen Finish | [ Concel | 
图 10-41 生成 签名 文件 信息 页 图 10-42 生成 打包 文件 页 


10.5.3 Android 应 用 项 目的 打包 签名 

在 签名 文件 生成 后 , 紧 接 着 是 要 对 应 用 项 目的 apk 文件 进行 签名 。 为 未 签名 的 apk 包 答 
名 也 有 两 种 方式 ; 一 是 使 用 命令 行 方式 ,二 是 使 用 ADT 插件 方式 。 

1. 使 用 命令 行 方式 

进入 命令 行 状态 ,在 存放 签名 文件 的 文件 夹 中 输入 命 令 : 


jarsigner -verbose -keystore keystore/lindand. keystore -signedjar mygooglemap s.apk 
mygooglemap. apk lindand. keystore 


在 输入 完 命令 之 后 回 车 ,再 输入 密码 (无 回 显 ) , 接 下 来 系统 将 进行 签名 ,如 图 10-43 所 示 。 


Nem exe. 


METR- INFZLINDAND. . 5i 
METR-INF/LINDAND . 


图 10-43 1E DOS 命令 行 状态 下 完成 签名 


命令 中 ,mygooglemap_s. apk 是 签名 后 的 包 文件 ,mygooglemap. apk 为 未 签名 的 包 文件 。 
完成 签名 后 ,为 了 确认 是 否 签名 成 功 ,可 以 输入 下 列 命令 给 予 验 证 : 
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jarsigner -verify mygooglemap s.apk 


如 果 出 现 “jar 已 验证 ,说 明 签名 成 功 , 如 图 10-44 所 示 。 


图 10-44 ”验证 签名 是 否 成 功 


2. 使 用 ADT 插件 方式 


仍 是 使 用 Export Signed Application Package... 选 项 。 其 操作 步骤 如 下 。 

CD 选择 需要 发 布 的 项 目 ,然后 右 击 。 

(2) 在 弹出 菜单 中 选择 Android Tools? Export Signed Application Package... o 

(3) f£ Keystore selection 页 (如 图 10-40 所 示 ) 中 ,选择 Use existing keystore, 输 入 密码 ， 
然后 单 击 Next 按钮 ,验证 签名 成 功 。 


(小 结 


本 章 主要 介绍 了 Android 平台 下 进行 网 络 数 据 通信 、 网 页 浏览 及 地 理 位 置信 息 应 用 等 与 
网 络 有 关 的 知识 和 应 用 。 通 过 案例 展示 了 Android 的 几 种 常见 网 络 应 用 技术 。 在 使 用 Socket 
开发 时 要 注意 通信 过 程 的 顺序 ; 使 用 URL 和 HTTP 获取 网 络 服务 器 上 信息 时 ,需要 正确 地 
搭建 Tomcat 服务 器 ,要 掌握 GET 和 POST 上 传 数据 的 区 别 用 法 ,这 些 都 是 非常 有 用 的 网 络 
编程 技术 。 在 地 理 位 置 定位 中 ,要 掌握 好 LocationManager 类 的 常用 方法 的 用 法 ; 在 使 用 
Google Map 时 要 会 申请 Map API Key。 学 会 了 这 些 技术 ,就 可 以 开发 面向 网 络 的 应 用 了 。 

至 此 ,读者 已 经 学 习 了 大 量 的 Android 编程 技术 ,具备 了 开发 一 般 应 用 项 目的 能 力 , 可 以 
将 自己 开发 的 项 目 发 布 应 用 了 。 所 以 在 本 章 的 最 后 一 节 介绍 了 应 用 程序 项 目 签名 打包 的 操作 
方法 。 在 前 面 各 章节 的 介绍 中 ,涉及 手机 功能 的 应 用 还 很 少 ,但 Andriod 系统 毕竟 是 始 于 手机 
的 操作 系统 ,与 手机 相关 的 应 用 开发 是 不 可 或 缺 的 ,第 11 章 将 补 上 这 一 缺失 。 


(练习 


1. 使 用 Tomcat 服务 器 (端口 号 为 8080) ,运用 线程 实现 多 客户 端的 连接 通信 功能 。 要 求 
服务 器 端 在 控制 台 客户 端 在 运行 界面 都 能 显示 登录 服务 器 的 IP 地 址 和 登录 的 次 数 这 些 信 
运行 结果 可 参考 图 10-45 和 图 10-46 。 


(E problems [E Console ri^. aë servers] @ Janadoc| 罗 Dedario DESIL- EA EISE 
a Applcatior] CAProgram Files Vai reGbieljerm.exe 2011.323 EA 034935] 


sel t ...uaer/182.168.1.102come toal:1 
/192.168.1.102:Be110,Bow are you! 


图 10-45 服务 器 端 在 控制 台 的 显示 结果 
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Hello,How are youl 


图 10-46 客户 端 在 屏幕 上 的 显示 结果 


完善 “掌上 博客 ”: 将 登录 信息 上 传 至 服务 器 中 进行 验证 。 
设计 一 个 可 以 向 前 、 向 后 浏览 网 页 的 应 用 。 
4. 设计 一 个 以 交通 地 图 的 形式 ,即时 显示 你 的 地 理 位 置 的 应 用 , 即 


位 ,并 签名 打包 。 


Se w to 


-个 简单 的 GPS 定 


手机 基本 功能 开发 | 


本 章 将 对 手机 的 一 些 特 有 功能 的 开发 进行 介绍 ,包括 收发 短信 、E-mail 邮件 ,拨打 电话 ， 


查看 手机 的 设置 和 状态 ,以 及 传感器 等 。 


(1.1 短信 控制 


短信 服务 (Short Message Service, SMS) 在 手机 使 用 中 几率 比较 大 。 尽 管 手机 中 都 有 定 
制 短信 管理 工具 ,但 有 时 候 用 户 需 要 按 自己 的 意图 来 定义 短信 收发 管理 ,所 以 掌握 管理 短信 的 
相关 功能 开发 在 手机 应 用 中 非常 有 用 。 对 手机 的 短信 控制 可 包括 短信 发 送 、 接 收 和 群发 短信 ， 


以 及 查询 发 送 的 状态 等 。 
11.1.1 发 送 短信 


Android 发 送 短信 其 实 很 简单 ,关键 的 类 是 SmsManager, 它 位 于 android. telephony fu 
下 。SmsManager 类 是 发 送 短信 的 工具 类 。 每 个 SmsMessage 对 象 都 包含 短信 的 详细 信息 ， 
例如 : 发 送 者 的 电话 号 码 , 时 间 稚 和 短信 息 内 容 。SmsMassage 字符 串 的 表现 形式 是 一 组 
pdus 串 。SmsManager 类 常用 于 发 送 短信 的 方法 如 表 11-1 所 示 。 


表 11-1 SmsManager 类 常用 的 方法 及 说 明 


方 È 


LEE: 


divideMessage(String text) 


getDefault() 


sendTextMessage ( String destinationAddress, String 
scAddress. String text. PendingIntent sentIntent, 
PendingIntent deliveryIntent) 


sendMultipart Text Message String destinationAddress, 
String scAddress. ArrayList < String > parts, 
ArrayList < PendingIntent> sentIntents, 

ArrayList < PendingIntent> deliveryIntents) 


当 短 信 超 过 SMS 消息 的 最 大 长 度 时 ,将 短信 分 割 为 几 
段 。 其 中 ,text 是 初始 的 消息 ,不 能 为 空 。 返 回 值 为 有 序 
的 ArrayList- String" ,可 以 重新 组 合 为 初始 的 消息 
获取 SmsManager 的 默认 实例 。 返 回 值 为 SmsManager 
的 默认 实例 

发 送 一 个 基于 SMS 的 文本 。 其 中 , destination Address 
是 消息 的 目标 地 址 ; scAddress 是 服务 中 心地 址 ; text 
是 初始 的 消息 ; sentIntent 是 当 消 息 成 功 发 送 或 失败 ， 
这 个 对 象 就 广播 ,这 个 参数 最 好 不 为 空 ,否则 会 存在 资 
源 浪费 的 潜在 问题 ; deliveryIntent 是 当 消 息 成 功 发 送 
到 接收 者 这 个 对 象 就 广播 

发 送 一 个 基于 SMS 多 部 分 文本 ,调用 者 应 用 已 经 通过 
调用 divideMessage(String text) 将 消息 分 割 成 正确 的 
大 小 。 参 数 与 sendTextMessage 方法 中 一 样 ,不 过 


sentIntents 和 deliveryIntents 是 一 组 PendingIntent 
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注意 ,开发 发 送 短信 的 应 用 时 ,要 在 AndroidManifest. xml 中 添加 发 送 SMS 权限 ,否则 应 


用 程序 无 法 执行 发 送 短信 任务 。 具 体 做 法 是 在 二 manifest 二 标签 下 添加 如 下 语句: 


<uses - permission android:name = "android. permission. SEND_SMS"/> 


下 面 通过 一 个 发 送 短信 的 案例 来 说 明 其 用 法 。 
【案例 11.1】 设计 一 个 可 发 送 短信 的 应 用 ,要 求 当 短信 的 字数 超过 70( 以 Unicode 字符 


单位 计 ) 时 进行 分 割 。 


【说 明 】 本 例 只 开发 发 送 短信 的 应 用 ,接收 短信 的 操作 由 系统 的 短信 管理 程序 负责 处 理 。 
【开发 步骤 及 解析 】 
CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 SMSSendDemo 的 Android 项 目 。 其 应 用 程序 名 


为 SMSSendDemo, 包 名 为 cn. com. sgmsc. sendSMS, Activity 组 件 名 为 SMSSendDemoActivity。 


(2) 准备 字符 串 资源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 

2 «resources» 

3 

4 < string name = "hello"» Hello World, SMSSendDemoActivity!«/string? 
5 < string name = "app name"» SMSSendDemo </string > 

6 < string name = "send"> 发 送 短信 </string> 

7 < string name = "sms"> 短 信 内 容 </string> 

8 < string name = "tel"> 对 方 号 码 </string> 

$ 

E 


0 «/resources?» 
(D 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 
1 <?xml version- "1.0" encoding = "utf - 8"?» 


2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:gravity- "top"><! -- 添加 一 个 垂直 的 线性 布局 --» 
7 < TextView 

8 android: text = "(3 string/tel" 

9 android:id- "(à + id/tv01" 

10 android:textSize - "20dip" 

11 android:textStyle = "bold" 

12 android:layout width = "wrap content" 
13 android:layout height = "wrap content" 
14 android:paddingLeft = "5dip"/»«! -- 添加 一 个 TextView 控件 --> 
15 «EditText 

16 android:id- "(9 + id/snstel" 

17 android:layout width- "fill parent" 
18 android:layout height = "wrap content" 
19 android:textStyle = "normal" 

20 /> 

21 «-- 添加 一 个 EditText 控件 --> 

22 <TextView 

23 android: text = "@string/sms" 

24 android:id- "@ + id/tv02" 

25 android:layout width- "wrap content" 


26 android:textSize = "20dip" 


java 
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android:textStyle = "bold" 
android:paddingLeft = "5dip" 
android:layout height = "wrap_content"/><! -- 添加 一 个 TextView 控件 --> 


<EditText 


android:id- "@ + id/smsContent" 
android:layout width= "fill parent" 
android:singleLine = "false" 
android:gravity = "top| left" 
android:layout height = "280dip" 
android:textStyle = "normal" 

/> 

<!-- 添加 一 个 EditText 控件 --> 


« Button 


android: text = "(9 string/send" 

android: id = "(à + id/smsSend" 

android: textSize = "20dip" 

android:layout width = "fill parent" 

android:layout height = "wrap content"/»«! -- 添加 一 个 Button 控件 --> 


45 </LinearLayout > 


(4) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. sendSMS 包 下 的 SendSMSDemoActivity. 


文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. sendSMS; 


import android. app. Activity; 

import android. app. PendingIntent; 
import android. content. Intent; 
import android. os. Bundle; 

import android. telephony. SmsManager; 
import android. view. View; 

import android. widget.Button; 

import android. widget. EditText; 
import android. widget. Toast; 

import java. util. List; 


public class SMSSendDemoActivity extends Activity ( 
private EditText txtNo; 
private EditText txtContent; 


private Button btnSend; 


@Override 
public void onCreate(Bundle icicle) { 


super. onCreate( icicle); 

setContentView(R. layout. main); 

txtNo = (EditText) findViewById(R. id. smstel); 
txtContent = (EditText) findViewById(R. id. smsContent) ; 
btnSend = (Button) findViewById(R. id. smsSend) ; 


btnSend. setOnClickListener(new View.OnClickListener() { 
(QOverride 


public void onClick(View v) ( 
String strNo = txtNo.getText().toString(); 
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33 String strContent = txtContent.getText().toString(); 

34 SmsManager smsManager = SmsManager.getDefault(); 

35 PendingIntent sentIntent = 

36 PendingIntent. getBroadcast(SMSSendDemoActivity.this, 0, new Intent(), 0); 

37 // 如 果 字 数 超过 70( 个 Unicode 字符 ), 需 拆 分 成 多 条 短信 发 送 

38 if (strContent. length() > 70) { 

39 // 使 用 短信 管理 器 进行 短信 内 容 的 分 段 ,返回 分 成 的 段 

40 List«String» msgs = smsManager. divideMessage(strContent); 

41 for (String msg : nsgs) { 

42 // 使 用 短信 管理 器 发 送 短信 内 容 

43 smsManager.sendTextMessage(strNo, null, msg, sentIntent, null); 

44 ) 

45 } else ( 

46 smsManager. sendTextMessage(strNo, null, strContent, sentIntent, null); 

47 } 

48 Toast . nakeText ( SMSSendDemoActivity. this，" 短 信 发 送 完成 "，Tbast. LENGTH_LONG) . 
show() ; 

49 } 

50 n 

51 ) 

52 } 


D 第 34 行 ,创建 一 个 默认 的 SmsManager 对 象 。 

© 第 35 行 ,创建 一 个 PendingIntent 对 象 , 作 为 发 送 短信 时 的 一 个 广播 对 象 。 

© 第 40 行 ,调用 divideMessage() 方 法 ,将 超出 70 个 字 的 短信 分 制 成 多 条 短信 ,存放 在 
List String Xf $ ri, 

@ 58 41—44 T IRE AE e Ad fri il E T ERI XE List String ^E Sp fg b — 4 
短信 ,调用 send Text Message O 7j ETT Az 3X , 

(5) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml 文件 ,在 二 manifest > 标签 内 添加 
下 列 权限 : 


< uses - permission android:name = "android. permission. SEND_SMS"/><! -- 添加 权限 --> 


【运行 结果 】 在 Eclipse 中 启动 两 个 Android 模拟 
器 ,其 模拟 器 号 分 别 为 5554 和 5556。 然 后 运行 MUR 
SMSSendDemo 项 目 。 如 果 系 统 选用 5556 模拟 器 运行 - 
程序 ,在 其 屏幕 上 可 输入 对 方 的 手机 号 ,在 本 例 中 使 用 
的 是 5554; 再 输入 短信 和 内容, 然后 单 击 * 发 送 短信 ? 按 
钮 ,将 短信 发 送 到 指定 方 的 手机 上 ,如 图 11-1 所 示 。 
这 时 将 从 5554 模拟 器 的 状态 栏 中 看 到 接收 到 短信 的 
通知 。 向 下 拉 开 状态 栏 ,可 以 看 到 收 到 一 条 来 自 
15555215556 的 短信 ,如 图 11-2 所 示 ; 双击 该 通知 可 
以 打开 看 到 详细 的 短信 和 内容, 如 图 11-3 所 示 。 当 然 ， 
也 可 不 下 拉 开 状态 栏 ,而 是 单 击 menu 按钮 ,在 屏幕 上 
出 现 许多 应 用 程序 ,其 中 有 个 Messaging 应 用 ,如 
图 11-4 所 示 , 它 就 是 系统 提供 的 短信 管理 程序 。 打 开 
它 也 可 以 看 到 详细 的 短信 内 容 。 图 11-1 从 5556 模拟 机 上 发 出 短信 


5554 


Happy birthday to you! 
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June 13, 2012 E wi & 06:35 


"VS 
1:555:521:5556. 


B3 15555215556 


DevTools Downloads 


© 


Messaging ^ Music 


15555215556: Happy 6 天 
birthday to you! A 


图 11-2 1E 5554 模拟 机 上 图 11-3 浏览 详细 短信 内 容 图 11-4 通过 menu 键 调 出 应 用 
拉 下 状态 栏 程序 图 标 


11.1.2 群发 短信 


群发 短 消息 ,实际 上 是 设置 一 个 循环 ,对 需要 发 送 的 号 码 逐 一 发 送 即 可 。 把 需要 发 送 的 联 
系 人 信息 记录 在 一 个 HashMap 中 ,HashMap 是 一 种 非常 常用 的 数据 类 型 一 “链表 散 列 ”。 


群发 时 ,通常 都 是 从 手机 通讯 录 中 选取 联系 人 ,然后 存放 到 HashMap 中 。 其 编程 过 程 及 关键 
的 代码 如 下 。 


T. 


ou mw 


[ x 


10 
EI 
12 
13 
14 


切换 到 通讯 录 


Uri uri = Uri.parse("content://contacts/people"); 
Intent intent = new Intent(Intent. ACTION PICK, uri);  // 创 建 Intent 
startActivityForResult(intent, 1); // 切 换 到 通讯 录 


. 从 通讯 录 中 得 到 联系 人 姓名 和 电话 号 码 


ContentResolver cr = getContentResolver(); // 得 到 ContentResolver 对 象 
Cursor c = managedQuery(myUrl, null, null, null, null); 
c.moveToFirst(); 
int nameFieldColumnIndex = c.getColumnIndex(PhoneLookup.DISPLAY NAME) ;// 取 得 联系 人 名 字 
String sName = c.getString(nameFieldColumnIndex); // 得 到 姓名 
String contactId = c.getString(c.getColumnIndex(ContactsContract.Contacts. ID)); 

// 取 得 联系 人 ID 


Cursor phone = cr.query(ContactsContract. CommonDataKinds. Phone. CONTENT URI, null, 


ContactsContract. CommonDataKinds.Phone.CONTACT ID" =" + contactld,null, null); 
String strPhoneNumber - ""; // 取 得 电话 号 码 (如 果 存 在 多 个 号 码 ,只 取 一 个 ) 
If(phone. moveToNext()) { // 得 到 一 个 电话 号 码 

strPhoneNumber = 


phone. getString(phone. getColunnIndex(ContactsContract. CommonDataKinds. Phone. NUMBER) ) ; 


) 
Peoples.put(sName, strPhoneNumber); — // 存 放 到 容器 中 


378 


VvV 


Android 应 用 开发 教程 


3. 取 HashMap 中 的 值 


Iterator 是 对 集合 进行 迭代 的 迭代 器 ,可 实现 对 集合 元 素 的 遍历 。 在 这 里 ,使 用 Iterator 
取 HashMap 中 的 集合 元 素 值 。 


1 HashMap< String, String» peoples = new HashMap<String, String»(); // 存 储 所 有 选择 的 


// 联 系 人 信息 
r 
3 Set keySet = peoples. keySet( ); // 得 到 键 值 集合 
4 Iterator ii = keySet.iterator(); 
5 people.setText(""); // 置 空 
6 while(ii.hasNext())( 
" Object key = ii.next(); // 得 到 键 值 
8 String tempName = (String)key; // 姓 名 
9 String tempPhone = peoples.get(key); // 得 到 电话 号 码 
10 wg 
11} 


11.1.3 接收 短信 


根据 接收 短信 时 系统 广播 的 android. provider. Telephony. SMS_RECEIVED 的 Intent. 
可 以 扩展 一 个 BroadcastReceiver 来 接收 SMS, BroadcastReceiver 是 在 后 台 进 行 监听 ,一 旦 接 
收 到 短信 ,就 会 触发 运行 。 使 用 BroadcastReceiver 需要 注册 ,如 果 在 AndroidManifest. xml 
中 注册 ,需要 在 二 application 之 标签 下 加 入 下 列 代码 
< receiver android:name = ". MyBroadcastReceiver"> 
< intent - filter» 
«action android:name = "android. provider. Telephony. SMS RECEIVED" /» 
«/intent - filter» 
</receiver> 
并 且 还 要 在 AndroidManifest. xml 的 二 manifest 二 下 添加 接收 短信 的 权限 。 具 体 语 句 
如 下 : 


< uses - permission android:name = "android. permission. RECEIVE_SMS"/> 


另外 ,在 接收 短信 的 应 用 中 需要 编写 一 个 SMS 的 广播 接收 器 类 ,在 该 类 中 要 有 以 下 4 个 
关键 性 代码 。 

CD 接收 短信 的 Broadcast Action 是 android. provider. Telephony. SMS_RECEIVED, 因 
此 ,要 在 onReceiver() 方 法 的 开始 部 分 判断 接收 到 的 是 否 是 接收 短信 的 Broadcast Action。 

(2) 需要 通过 Bundle. get("pdus") 来 获得 接收 到 的 短信 消息 。 这 个 方法 返回 了 一 个 表示 
短信 内 容 的 数组 。 每 一 个 数组 元 素 表示 一 条 短信 。 这 就 意味 着 通过 Bundle. get("pdus") 可 以 
返回 多 条 系统 接收 到 的 短信 内 容 。 

(3) 通过 Bundle. get("pdus") 返 回 的 数组 一 般 不 能 直接 使 用 ,需要 使 用 SmsMessage. 
createFromPdu( ) 方法 将 这 些 数组 元 素 转换 成 SmsMessage 对 象 才 可 以 使 用 。 每 一 个 
SmsMessage 对 象 表示 一 条 短信 。 

(4) 通过 SmsMessage 类 的 getDisplayOriginatingAddress() 方 法 可 以 获得 发 送 短信 的 电 
话 号 码 。 通 过 getDisplayMessageBody() 方 法 可 以 获得 短信 的 内 容 。 
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这 里 ,Android 设备 收发 SMS 是 以 PDU(Protocol Description Unit) 编 码 形式 来 传输 的 。 
11.1.4 查询 发 送 状态 


当 发 送 短信 的 命令 发 出 之 后 ,会 有 多 种 状态 ,如 发 送 成 功 ,或 发 送 暂停 ,或 发 送 失 败 等 。 这 
些 状 态 有 时 需要 反馈 给 用 户 。 查 询 短 信 发 送 状 态 需要 注册 BroadcastReceiver, 并 且 其 查询 状 
态 代码 要 在 BroadcastReceiver 内 的 onReceive( ) 方 法 中 编写 ,根据 得 到 的 结果 值 判断 短信 发 
送 的 状态 。 

BroadcastReceiver 接收 到 的 Intent 中 包含 的 状态 值 如 下 。 

A Activity. RESULT_OK 一 一 发 送 成 功 。 

æ SmsManager. RESULT_ERROR_GENERIC_FAILURE 一 一 发 送 失 败 , 值 为 1。 

æ SmsManager. RESULT_ERROR_RADIO_OFF 一 一 无 线 连接 异常 , 值 为 2。 

æ SmsManager. RESULT_ERROR_NULL_PDU— PDU 为 空 值 , 值 为 3。 

名 SmsManager. RESULT_ERROR_NO_SERVICE 一 一 服务 不 可 用 , 值 为 4。 

下 面 通过 一 个 收发 短信 的 案例 来 说 明 短信 控制 应 用 。 

【案例 11.2】 开发 一 个 短信 收发 的 应 用 ,要 求 发 出 短信 后 能 提示 短信 发 送 的 状态 信息 ， 
对 方 收 到 短信 后 回复 ,能 给 出 接收 回复 的 简要 信息 。 

[58] 接收 短信 的 应 用 是 由 Android 系统 提供 的 短信 管理 应 用 程序 负责 。 本 例 是 要 针 
对 发 送 短信 方 的 用 户 体验 而 编程 的 ,其 内 容 包括 发 送 短信 ,反馈 发 送 短信 状态 ,接收 对 方 回复 
短信 时 的 提示 信息 。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 SMSDemo 的 Android 项 目 。 其 应 用 程序 名 
为 SMSDemo, 包 名 为 cn. com. sgmsc. SMS. Activity 组 件 名 为 SMSSendActivity , 

(2) 准备 字符 串 资源 。 编 写 res/layout 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 
2 <resources> 


3 

4 < string name = "hello"> Hello World, SMSSendActivity!«/string» 

5 < string name = "app name"» SMSDemo </string > 

6 < string name = "totel"» Please input the TEL No:«/string? 

7 < string name = "smscontent"» Please input the SMS content :</string > 
8 < string name = "sendbtn"» SEND </string > 

9 < string name = "nessage"» send successfully!«/string» 

10 


11 «/resources > 
(3) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?» 
2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:gravity = "top"><! —— 添加 一 个 垂直 的 线性 布局 --» 
< TextView 
android: text = "@string/totel" 
android: id= "(2 + id/tv01" 
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10 android:textSize = "18sp" 

1l android:textStyle = "bold" 

12 android:layout width- "wrap content" 
13 android:layout height = "wrap content" 
14 android:paddingLeft = "5dip"/»«! -- 添加 一 个 TextView 控件 --> 
15 «EditText 

16 android:id- "(à + id/smsTel" 

17 android:layout width- "fill parent" 
18 android:layout height = "wrap content" 
19 android:textStyle = "normal" 

20 ^ 

21 <! -- 添加 一 个 EditText 控件 --> 
22 < TextView 

23 android:text = "@ string/smscontent" 
24 android:id= "(9 + id/tv02" 

25 android:layout width- "wrap content" 
26 android:textSize = "18sp" 

27 android:textStyle = "bold" 

28 android:paddingLeft = "5dip" 

29 android:layout height = "wrap content"/»«! -- 添加 一 个 TextView 控件 --> 
30 <EditText 

31 android:id- "(9 + id/smsContent" 

32 android:layout width- "fill parent" 
33 android: singleLine = "false" 

34 android:gravity = "top| left" 

35 android:layout height = "280dip" 

36 android:textStyle = "normal" 

37 /> 

38 <! -- 添加 一 个 EditText 控件 --> 
39 < Button 

40 android:text = "@ string/sendbtn" 

41 android: id= "@ + id/smsSend" 

42 android:textSize = "20dip" 

43 android:layout width- "fill parent" 
44 android:layout height = "wrap content"/»«! -- 添加 一 个 Button 控件 --» 


45 </LinearLayout > 


第 34 行 ,设置 该 EditText 居 上 、 居 左 对 齐 。 当 android: gravity 需要 设置 多 个 值 时 ,可 以 
使 用 “1” 进行 分 隔 。 

CD 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. SMS 包 下 的 SendSMSActivity. java 文件 ， 
并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. SMS; 


import java.util.List; 


import android. app. PendingIntent; 
import android. content. BroadcastReceiver; 
import android. content. Context; 
import android. content. Intent; 
10 import android. content. IntentFilter; 
11 import android. os. Bundle; 
12 import android. telephony. SmsManager; 
13 import android. view. View; 


1 
2 
3 
4 
5 import android. app. Activity; 
6 
7 
8 
9 


14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
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import android. widget. Button; 
import android. widget. EditText; 
import android. widget. Toast; 


public class SMSSendActivity extends Activity { 


String SENT SMS ACTION = "SENT SMS ACTION"; 
String DELIVERED SMS ACTION = "DELIVERED SMS ACTION"; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout.main); 


Button btn = (Button)findViewById(R. id. smsSend) ; 
btn. setOnClickListener(new View.OnClickListener() { 


public void onClick(View arg0) { 
EditText telNoText - (EditText)findViewById(R. id. smsTel); 
EditText contentText - (EditText)findViewById(R. id. smsContent) ; 


String telNo = telNoText.getText().toString(); 
String content = contentText.getText().toString(); 
if (validate(telNo, content)) 
{ 

sendSMS(telNo, content); 


ni 


/x* 发 送 SMS 方法 * / 
private void sendSMS(String phoneNumber, String message) ( 


/* 生成 sentIntent 参数 * / 

Intent sentIntent = new Intent(SENT SMS ACTION); 

PendingIntent sentPI - PendingIntent.getBroadcast(this, 0, sentIntent, 0); 

/* 生成 deilverIntent 参数 * / 

Intent deliverIntent - new Intent(DELIVERED SMS ACTION); 

PendingIntent deliverPI - PendingIntent.getBroadcast(this, 0, deliverIntent, 0); 


SmsManager sms = SmsManager.getDefault(); 
if (message. length() > 70) { 
List«String» msgs = sms.divideMessage(message); 
for (String msg : msgs) ( 
sms. sendTextMessage(phoneNumber, null, msg, sentPI, deliverPI); 
} 
) else { 
sms. sendTextMessage(phoneNumber, null, message, sentPI, deliverPI); 
) 
"loast.makeText (SMSSendActivity.this, R. string. message, Toast.LENGTH LONG).show(); 


/ * 注册 BroadcastReceivers, 广播 短信 发 送 状态 * / 
registerReceiver(new BroadcastReceiver()( 
(QOverride 
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public void onReceive(Context context,Intent intent) 
t 
switch(getResultCode())( 
case Activity.RESULT OK: 
Toast. makeText (getBaseContext(), 
"SMS sent success actions", 
Toast.LENGTH SHORT). show(); 
break; 
case SmsManager. RESULT ERROR GENERIC FAILURE: 
Toast. makeText (getBaseContext(), 
"SMS generic failure actions", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager. RESULT ERROR RADIO OFF: 
Toast. makeText (getBaseContext(), 
"SMS radio off failure actions", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager. RESULT ERROR NULL PDU: 
Toast. makeText (getBaseContext(), 
"SMS null PDU failure actions", 
Toast.LENGTH SHORT). show(); 
break; 


} 
new IntentFilter(SENT_SMS_ACTION) ); 
registerReceiver(new BroadcastReceiver()( 

@Override 

public void onReceive(Context _context, Intent _intent) 

{ 

Toast. nakeText (getBaseContext(), 
"SMS delivered actions", 
Toast. LENGTH SHORT). show(); 


) 
new IntentFilter(DELIVERED SMS ACTION)); 
) 
/* 判断 输入 信息 的 有 效 性 * / 
public boolean validate(String telNo, String content)( 


if((null-- telNo)||("".equals(telNo. trim()))){ 
Toast.makeText(this, "please input the telephone No. ! ", Toast. LENGTH LONG) . show( ) ; 
return false; 

) 

if((null-- content) | | ("". equals(content. trim())))( 
"lpast.makeText (this, "please input the message content! ",Toast.LENGTH LONG). show() ; 
return false; 

) 


return true; 
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(D 588 46—106 行 ,定义 了 sendSMS() 方 法 。 其 中 第 49 一 64 行 是 发 送 短信 的 代码 ; 第 
67 一 94 行 是 注册 一 个 BroadcastReceiver, 并 在 重 写 其 onReceive() 方 法 中 ,根据 不 同 的 发 送 状 
态 结果 提示 不 同 的 消息 。 第 95 行 创建 过 滤器 。 

© 第 108—119 行 , 定 义 判断 输入 的 手机 号 码 和 短信 内 容 是 否 为 空 ,以 此 来 保证 信息 的 有 
效 性 。 当 然 , 也 可 以 在 此 处 定义 更 多 的 如 验证 手机 号 码 是 否 合法 等 判断 代码 。 

(5) 开发 接收 短信 广播 接收 器 类 代码 。 在 src/cn. com. sgmsc. SMS 包 下 新 建 一 个 名 为 
SMSReceiver. java 的 文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. con. sgnsc. SMS; 


import android. content.BroadcastReceiver; 
import android. content. Context; 

import android. content. Intent; 

import android. os. Bundle; 

import android. telephony. SmsMessage; 
import android. widget. Toast; 


public class SMSReceiver extends BroadcastReceiver { 


private static final String strRes = "android. provider. Telephony. SMS RECEIVED"; / / Ift $3] fff] 
// 是 短信 


@Override 
public void onReceive(Context arg0, Intent argl) { 
/* 判断 接收 到 的 广播 是 否 为 收 到 短信 的 Broadcast Action * / 
if(strRes.equals(argl.getAction()))( 
StringBuilder sb = new StringBuilder(); 
/* 接收 由 SMS 传 过 来 的 数据 * / 
Bundle bundle = argl.getExtras(); 
/* 判断 是 否 有 数据 * / 
if(bundle!- null)( 
/ * 通过 pdus 可 以 获得 接收 到 的 所 有 短信 消息 * / 
Object[ ] pdusArray = (Object[])bundle.get("pdus") ; 
/* 构建 短信 对 象 array, 并 依据 收 到 的 对 象 长 度 来 创建 array 的 大 小 * / 
SmsMessage[ ] msg = new SmsMessage[pdusArray. length]; 
for(int i = 0 ;i« pdusArray. length; i++ )( 
msg[i] = SmsMessage. createFromPdu( (byte[ ]) pdusArray[ i]); 
) 
/* 将 送 来 的 短信 合并 自 定义 信息 于 StringBuilder 当中 / 
for(SmsMessage curMsg:msg) ( 
Sb. append(" You got the message Fron:["); 
sb. append(curMsg. getDisplayOriginatingAddress()); // 获 得 接收 短信 的 
// 电 话 号 码 
sb. append("]Content: "); 
sb. append(curMsg. getDisplayMessageBody()) ; // 获 得 短信 的 内 容 
) 
Toast. makeText(argO, 
"Got The Message:" * sb.toString(), 
Toast.LENGTH SHORT).show(); 
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第 26 行 ,如 果 回 复 的 短信 过 长 ,会 被 分 割 成 多 条 短信 ,因此 使 用 数组 msg 比较 好 。 

(6) 注册 广播 接收 器 ,添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml 文件 ,并 编辑 
其 代码 如 下 所 示 。 


N 


1 <?xml version - "1.0" encoding = "utf - 8"?> 
2 «manifest xmlns:android = "http: //schemas. android. com/apk/res/android" 


3 package = "cn. com. sgmsc. SMS" 

4 android:versionCode = "1" 

5 android:versionName - "1.0" » 

6 

7 « application 

8 android: icon = "(Zdrawable/ic launcher" 

9 android: label = "@string/app_name" > 

10 <activity 

11 android: label = "@string/app_name" 

12 android:name = " , SMSSendActivity" > 

13 < intent - filter > 

14 <action android:name = "android. intent. action. MAIN" /> 

15 < category android:name = "android. intent. category. LAUNCHER" /> 
16 </intent - filter > 

17 «/activity» 

18 < receiver android:name = ".SMSReceiver" android:enabled- "true" > 

19 < intent- filter» 

20 « action android:name = "android. provider. Telephony. SMS. RECEIVED" /> 
21 </intent - filter» 

22 </receiver> 


23 </application> 

24 <uses - sdk android:minSdkVersion = "10" /> 

25 < uses - permission android:name = "android. permission. SEND_SMS"/> 

26 « uses - permission android:name = "android. permission. RECEIVE SMS"/» 

m «/nanifest» 

【运行 结果 】 在 Eclipse 中 启动 两 个 Android 模拟 器 ， 
其 模拟 器 号 分 别 为 5554 和 5556。 然 后 运行 SMSDemo 项 
目 。 如 果 系 统 选 用 5556 模拟 器 运行 程序 ,在 其 屏幕 上 
可 输入 对 方 的 手机 号 ,在 本 例 中 使 用 的 是 5554; 再 输入 nct mS 
短信 内 容 , 如 图 11-5 所 示 , 然 后 单 击 SEND 按钮 ,将 短 TS e ee 
信 发 送 到 指定 方 的 手机 上 。 由 于 短信 内 容 超过 了 70 个 onset message from sese 
字符 ,所 以 这 时 将 从 5554 模拟 器 的 状态 栏 中 看 到 接收 [ Ihe me rom 
到 两 条 来 自 15555215556 的 短信 通知 ,如 图 11-6 所 示 。 
双击 该 通知 条 目 可 以 打开 浏览 其 详细 内 容 , 并 进行 回 
复 , 如 图 11-7 所 示 。 当 回复 信息 发 出 后 ,5556 模拟 器 随 
即 收 到 回复 信息 ,显示 收 到 短信 的 消息 提示 ,如 图 11-8 


所 示 。 图 11-5 从 5556 模拟 机 上 发 出 短信 


SMSReceiveDemo 


June 13, 2012 


Android 


1:555:521:5558 


15555215556: This is the 
message from 5556. 
This is the message from 

5556. 

This is the message from 

5556. 

This is the message from 


5556. 
This is the message from 55 


Sent: 05:19 


第 11 章 手机 基本 功能 开发 


XE 15555215554: Th 
SMSReceiveDemo — 

Please input the TEL No 

5554 

Please input the SMS content: 
This is the message from 5556. 
This is the message from 5556. 
This is the message from 5556. 
This is the message from 5556. 


This is the message from 5556. 
This is the message from 5556] 


15555215556: 56. 


This is the message from Got The Message:You got the message. 
5556. From: [15555215554] Content : Thank 


: youl From 5554 
Sent: 05:19 


Thank you! From 5554 


图 11-6 在 5554 模 拟 机 上 
拉 下 状态 栏 


11-7 浏览 5554 模拟 机 上 的 
短信 并 回复 


图 11-8 5556 模拟 机 收 到 
短信 提示 


11,2 电话 控制 


手机 的 电话 功能 是 最 基本 的 功能 。 在 应 用 程序 中 ,特别 是 通信 类 的 应 用 程序 , 常 做 的 事情 
是 对 电话 进行 控制 、 监 听 和 服务 ,如 能 够 监听 电话 的 呼 入 ,以 便 执行 暂停 音乐 播放 器 , 当 电 话 结 
束 之 后 ,再 恢复 播放 ,或 对 电话 进行 录音 ,或 在 应 用 程序 中 直接 拨打 电话 等 。 在 Android 平台 
可 以 通过 TelephonyManager 和 PhoneStateListener 来 完成 此 任务 。 


拨打 电话 


开发 拨打 电话 应 用 ,可 以 直接 调用 系统 的 dialer 拨号 程序 。 使 用 Intent 来 启动 本 地 的 拨 
号 程序 的 方式 可 以 是 Intent. ACTION_CALL ,也 可 以 是 Intent. ACTION. DIAL, 

以 使 用 Intent. ACTION. CALL 方式 为 例 ,如 果 按 钮 bDial 是 拨打 键 ,EditText 控件 et 内 
是 要 拨打 的 电话 号 码 ,那么 在 用 户 按 完 电话 号 码 后 单 击 该 按钮 ,这 个 按钮 的 OnClickListener 
监听 的 代码 如 下 。 


11:2: 


1 Button bDial- (Button)this. findViewById(R. id. Button dial); 

2 bDial.setOnClickListener(//79 i 5 fi HX JI Wi Wr 2 

3 //OnClickListener Jj View 的 内 部 接口 ,其 实现 者 负责 监听 鼠标 点 击 事件 
4 new View. OnClickListener()[ 

5 public void onClick(View v)( 

6 // 获 取 输 入 的 电话 号 码 

E. EditText et = (EditText)findViewById(R. id. EditText01); 
8 String num et. getText(). toString(); 

9 // 根 据 获 取 的 电话 号 码 创建 Intent 拨号 

10 Intent dial = new Intent(); 

pig dial. setAction( "android. intent. action. CALL"); 

12 dial. setData(Uri. parse("tel://" + num) ); 

13 startActivity(dial); // 激 活 打 电话 的 Activity 
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15 } 

16 ); 

拨打 电话 代码 程序 所 引入 的 类 都 是 以 前 学 习 过 的 ,并 没有 引入 新 类 。 但 是 需要 在 
AndroidManifest. xml 文件 中 为 应 用 程序 添加 打 电 话 的 权限 : 


< uses - permission android:name = "android. permission. CALL PHONE" /> 


11.2.2. 监听 电话 的 状态 


Android 中 所 有 与 电话 相关 的 API 都 由 TelephonyManager 类 来 管理 , TelephonyManager 类 
位 于 android. telephony 包 下 。TelephonyManager 作为 一 个 Service 接口 提供 给 用 户 查询 电 
话 相关 的 内 容 , 例 如 IMEI( 国 际 移动 装备 辨识 码 ),LineNumberl 等 。 

在 TelephonyManager 类 中 有 以 下 三 种 状态 。 

(1) TelephonyManager. CALL_STATE_IDLE 一 一 待机 状态 , 值 为 0。 

(2) TelephonyManager. CALL_STATE_RINGING 一 一 来 电 状态 ( 振 铃 ) , 值 为 1。 

(3) TelephonyManager. CALL_STATE_OFFHOOK 一 一 通话 中 ( 摘 机 ) , 值 为 2。 

对 电话 状态 进行 监听 ,需要 使 用 PhoneStateListener 类 。 该 类 也 位 于 android. telephony 
包 下 。 监 听 电 话 相 关 的 事件 诸如 : 响 铃 . 挂 断 .基站 位 置 变化 .语音 邮件 .呼叫 转移 等 。 
PhoneStateListener 类 常用 的 监听 通话 方法 如 表 11-2 所 示 。 


表 11-2 PhoneStateListener 类 监听 通话 方法 及 对 应 的 常量 说 明 


5 法 静态 常量 说 mH 
onCallForwardingIndicatorChanged LISTEN_CALL_FORWARDING_INDICATOR 监听 通话 转移 指示 变 
(boolean cfi) 化 回调 方法 和 常量 
onCallStateChanged(int state, String LISTEN_CALL STATE 监听 呼叫 状态 变化 的 
incomingNumber) 回调 方法 和 常量 
onCellLocationChanged(CellLocation | LISTEN. CELL LOCATION 监听 设备 单元 位 置 变 
location) 化 的 回调 方法 和 常量 
onDataActivityCint direction) LISTEN DATA ACTIVITY 监听 数据 流量 移动 方向 

变化 的 回调 方法 和 常量 
onDataConnectionStateChanged (int LISTEN_DATA_CONNECTION_STATE 监听 数据 连接 状态 的 
state) 变化 
onMessageWaitingIndicatorChanged | LISTEN MESSAGE WAITING INDICATOR 监听 消息 等 待 指示 变 
(boolean mwi) 化 的 回调 方法 和 常量 
onServiceStateChanged(ServiceState LISTEN SERVICE STATE 监听 网 络 服务 状态 变 
serviceState) 化 的 回调 方法 和 常量 
onSignalStrengthChanged(int asu) LISTEN SIGNAL STRENGTH 监听 网 络 信号 强度 变 

化 的 回调 方法 和 常量 


对 电话 状态 进行 监听 时 ,还 需要 在 AndroidManifest. xml 中 为 应 用 程序 添加 读 电话 状态 
的 权限 : 


< uses - permission android:name = "android. permission. READ_PHONE_STATE" /> 


在 Android 应 用 中 ,如 果 想 要 监听 电话 的 拨打 状况 ,需要 实现 以 下 步骤 。 


第 11 章 手机 基本 功能 开发 


(1) 获取 电话 服务 管理 器 实例 。 


TelephonyManager telephonyMgr = (TelephonyManager) 
this .getSystemService(Context. TELEPHONY SERVICE); 


(2) 通过 TelephonyManager 设置 要 对 电话 事件 的 监听 。 例 如 监听 呼叫 状态 改变 。 
telephonyMgr.listen(new TeleListener (),PhoneStateListener.LISTEN CALL STATE); 


如 果 需 要 设置 多 个 监听 ,可 以 在 listen() 方 法 的 第 二 个 参数 上 多 加 几 个 静态 常量 ,用 “|” 
隔 开 。 例 如 设置 呼叫 状态 改变 和 网 络 服务 状态 改变 监听 ， 
telephonyMgr. listen(new TeleListener (),PhoneStateListener.LISTEN CALL STATE | 
PhoneStateListener. LISTEN SERVICE STATE); 
并 且 TeleListener 需要 实现 父 类 的 几 个 方法 : onCallStateChangedO ,onServiceStateChangedO 。 
如 果 要 取消 对 电话 事件 的 监听 ， 


telephonyMgr.listen(TeleListener, PhoneStateListener.LISTEN NONE); 


(3) 通过 继承 PhoneStateListener 来 重 写 与 第 (2) 步 的 第 二 个 参数 对 应 的 回调 方法 ,在 这 
些 方法 中 定制 自己 的 规则 。 

(4) 这 一 步 很 重要 ,就 是 给 应 用 添加 权限 : android. permission. READ PHONE _STATE 。 

下 面 通过 一 个 案例 来 说 明 监听 电话 状态 的 用 法 。 

【案例 11.3】 开发 一 个 对 电话 呼叫 状态 进行 监听 的 应 用 ,并 将 状态 记录 下 来 显示 在 屏 


幕 上 。 
【说 明 】 该 案例 使 用 系统 自 带 的 拨打 电话 应 用 程序 进行 拨打 、 接 听 、 挂 起 等 操作 。 
【开发 步骤 及 解析 】 


(1) 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 TeleCallListener 的 Android 项 目 。 其 应 用 程序 名 为 
"TeleCallListener , 包 名 为 cn. com. sgmsc. TelListener ,Activity 组 件 名 为 TeleCallListenerActivity 。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,只 在 屏幕 上 放置 一 个 TextView 控 
件 ,其 ID 名 为 tv1。 在 此 省 略 其 代码 。 

G) 开发 馆 辑 代 码 。 打 开 src/cn. com. sgmsc. TelListener 包 下 的 TeleCallListenerActivity . 
java 文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. TelListener; 


t 
2 
3 import android. app. Activity; 

4 import android. os. Bundle; 

5 import android. telephony. PhoneStateListener; 
6 import android. telephony. TelephonyManager; 

7 import android. widget. TextView; 

8 


9 public class TeleCallListenerActivity extends Activity { 
10 TelephonyManager telmanager ; 

11 String result = "监听 电话 状态 : \n\n"; 

12  TextView textView ; 


13 (2 Override 

14 public void onCreate(Bundle savedInstanceState) ( 

15 super. onCreate(savedInstanceState); 

16 setContentView(R. layout. main); 

17 // 获 取 电 话 服务 

18 telmanager = (TelephonyManager) this. getSystemService(TELEPHONY SERVICE); 


19 // 手 动 注册 对 PhoneStateListener 中 的 listen call state 状态 进行 监听 
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20 telmanager.listen(new MyCallStateListener(), PhoneStateListener.LISTEN CALL STATE); 
21 

22 textView = (TextView) findViewById(R. id. tv1); 

23 textView. setText(result); 

24 } 


25 /* 继承 PhoneStateListener 类 ,可 以 重 写 其 内 部 的 各 种 监听 方法 
26 * 然后 通过 手机 状态 改变 时 ,系统 自动 触发 这 些 方法 来 实现 想 要 的 功能 


27 */ 

28 class MyCallStateListener extends PhoneStateListener{ 

29 @Override 

30 public void onCallStateChanged(int state, String incomingNumber) { 
31 switch (state) { 

32 case TelephonyManager.CALL STATE IDLE: 

33 result += "Æ, Wn"; 

34 break; 

35 case TelephonyManager.CALL STATE RINGING: 

36 result +=" 响 铃 ,来 电 号 码 :" + incomingNumber +", WM"; 
37 break; 

38 case TelephonyManager. CALL STATE OFFHOOK: 

39 result += " 挂 起 。\n"; 

40 default: 

41 break; 

42 } 

43 textView. setText(result); 

44 super.onCallStateChanged(state, incomingNumber); 
45 } 

46 } 

47 

48 ) 


(D 第 20 fT. Xf PhoneStateListener 中 的 LISTEN CALL STATE 状态 进行 监听 ,所 以 在 
MyCallStateListener 类 中 需要 重 写 onCallStateChanged() 方 法 。 

@ 第 28 一 46 行 ,定义 MyCallStateListener 类 ,并 重 写 onCallStateChanged() 方 法 ,在 该 
方法 中 将 TelephonyManager 的 状态 用 用 户 可 理解 的 文字 显示 在 TectView 控件 中 。 

(4) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml 文件 ,并 在 二 manifest 二 标签 中 加 
入 权限 : 


< uses - permission android:name = "android. permission. READ PHONE STATE"/» 


【运行 结果 】 在 Eclipse 中 启动 两 个 Android 模拟 器 ,其 模拟 器 号 分 别 为 5554 和 5556, 
然后 运行 TeleCallListener 项 目 。 如 果 选 用 5554 模拟 器 运行 程序 ,初始 运行 时 屏幕 显示 效果 
如 图 11-9 所 示 , 这 时 在 5556 模拟 器 中 启用 拨打 电话 应 用 拨打 号 码 为 “5554”, 则 5554 模拟 器 
会 做 出 应 答 ,显示 来 电 ,可 接 通 来 电 , 并 挂 起 片刻 后 再 恢复 通话 ,然后 挂 断 。 返 回 到 本 例 的 界 
和 ,如 图 11-10 所 示 。 


TelecaliListener 
监听 电话 状态 


2A, 


图 11-9 5554 模拟 器 初始 运行 界面 图 11-10 ”执行 完 接听 、 挂 起 、 挂 断 操作 后 
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(1:3 E-mail 功能 开发 
-i 


现在 手机 功能 越 来 越 强大 ,使 用 手机 发 E-mail 已 是 一 种 广泛 的 应 用 。Google 在 发 表 
Android 手机 平台 时 ,强调 的 是 超 强大 的 网 络 支 持 能 力 , 因 此 ,无 论 通 过 GPRS、3G 的 电信 网 
络 或 者 是 WIFI 的 WLAN ,都 能 够 发 E-mail。 

在 Android 平台 的 底层 是 采用 SMTP 进行 通信 的 , SMTP (Simple Mail Transfer 
Protocal) 即 简单 邮件 传输 协议 ,由 它 来 控制 信件 的 中 转发 送 方式 ,并 通过 Android 中 内 置 的 
Gmail 程序 完成 邮件 发 送 。 发 送 邮件 中 使 用 的 Intent 行为 为 android. content. Intent. 
ACTION_SEND。 

E-mail 功能 开发 非常 简单 ,在 这 里 只 给 出 发 送 E-mail 的 关键 代码 段 。 

Intent intent = new Intent(android. content. Intent.ACTION_SEND);// 创 建 Intent 

intent. setType( "plain/text"); // 设 置 邮件 格式 
strEmailReciver = new String[](text01.getText().toString()); // 将 收 件 人 放 入 Intent 中 
strEmailBody = text02.getText().toString(); 

intent. putExtra(android. content.Intent.EXTRA EMAIL, strEmailReciver); // 设 置 收 件 人 
intent. putExtra(android. content. Intent. EXTRA_TEXT, strEmailBody); // 设 置 内 容 


startActivity ( Intent. createChooser ( intent, getResources ( ). getString (R. string. str _ 
nessage))); // 打 开 Gmail 发 邮件 


vona wne 


(1.4 手机 特有 特性 开发 


手机 特有 的 特性 包括 : 响应 系统 设置 更 改 事件 ,手机 的 来 电 提醒 设置 ,音量 调节 ,SIM E 
和 电信 网 络 信息 ,手机 电池 电量 等 。 在 Android 系统 中 ,有 些 手 机 特有 的 特性 设置 的 变化 会 影 
响 到 应 用 程序 的 执行 。 


11.4.1 系统 设置 更 改 事件 


在 Android 中 ,系统 设置 信息 封装 在 一 个 Configuration 类 中 。Configuration 类 位 于 
android. content, res 包 下 ,主要 用 来 描述 与 能 让 应 用 程序 获取 的 资源 相关 的 所 有 硬件 配置 信 
息 。 例 如 系统 字体 大 小 ,方向 ,输入 设备 类 型 等 。 

在 应 用 程序 中 ,Android 的 默认 行为 不 是 总 是 令 人 满意 的 ,尤其 当 配 置 变化 (如 屏幕 方向 
和 键盘 可 视 ) .用 户 旋转 设备 或 划 出 键盘 等 。 可 以 通过 监测 和 响应 定制 自己 的 应 用 程序 来 对 这 
些 变化 做 出 响应 。 


1. 设置 configChanges 属性 


为 了 能 让 Activity 能 监听 实时 的 配置 变化 ,需要 在 AndroidManifest. xml 文件 中 的 
< 一 activity 二 标签 内 添加 “android:configChanges” 属 性 ,其 属性 值 用 于 指定 应 用 程序 要 处 理 的 
配置 变化 事件 。 常 用 的 属性 值 如 下 。 

(I) orientation 一 一 屏幕 在 纵向 和 横向 间 旋 转 。 

(2) keyboardHidden 一 一 键盘 显示 或 隐藏 。 


390 


Nf 


Android 应 用 开发 教程 


(3) fontScale 一 一 用 户 变 更 了 首选 的 字体 大 小 。 

(4) locale 一 一 用 户 选 择 了 不 同 的 语言 设 定 。 

(5) keyboard 一 一 键盘 类 型 变更 ,例如 手机 从 12 键盘 切换 到 全 键盘 。 

(6) touchscreen 或 navigation 一 一 触 屏 或 导航 方式 变化 ,一 般 不 会 发 生 这 样 的 事件 。 
在 该 属性 中 可 以 选择 多 个 值 , 用 |? 分 隔 。 例 如 ， 


android:configChanges = "orientation|keyboard|keyboardHidden" 


添加 上 述 属性 的 含义 是 表示 在 改变 屏幕 方向 、 弹 出 软件 盘 和 隐藏 软 键盘 时 ,不 再 去 执行 
onCreate() 方 法 ,而 是 直接 执行 onConfigurationChanged() 方 法 。 如 果 不 声明 此 段 代码 ,按照 
Activity 的 生命 周期 , 当 改变 屏幕 方向 .弹出 软件 盘 和 隐藏 软 键盘 时 ,都 会 去 执行 一 次 
onCreate() 方 法 ,而 onCreate() 方 法 通常 会 做 一 些 初始 化 工作 。 这 样 ,往往 会 降低 程序 效率 ， 
或 需要 做 许多 工作 来 避免 因 初 始 化 而 造成 已 得 到 的 数据 的 丢失 ,给 程序 的 编码 带 来 逻辑 的 复 
杂 性 。 

另外 ,为 了 让 Android API 允许 用 户 改 变 配 置信 息 , 还 必须 在 AndroidManifest. xml 的 文 
件 中 添加 一 权限 : 


< uses - permission android:name = "android. permission. CHANGE CONFIGURATION" /> 


2. 响应 Configuration 的 变化 


很 多 时 候 配 置 改变 (Configuration Change) 了 ,例如 经 常 遇 到 的 屏幕 横向 纵向 进行 切换 ， 
一 般 会 重新 加 载 Activity. 这 样 切 换 起 来 会 看 到 界面 非常 的 和 内。 如 果 使 用 了 
onConfigurationChanged() 方 法 就 可 以 很 好 地 解决 这 个 问题 。 

如 果 期 望 在 代码 中 响应 系统 设置 的 变化 ,可 以 通过 重 写 Activity 类 的 onConfigurationChanged() 
方法 来 实现 。 在 onConfigurationChanged() 方 法 内 ,根据 Configuration 的 不 同 配置 值 进入 不 
同 的 事件 中 进行 处 理 。Configuration 类 常用 的 系统 设置 有 如 下 几 个 方面 。 

CD 屏幕 的 朝向 。 可 取 的 值 有 ORIENTATION_PORTRAIT( 值 为 D,ORIENTATION 
_LANDSCAPE( 值 为 2) ,. ORIENTATION SQUARE((É 3). 

(2) 键盘 显示 或 隐藏 。 可 取 的 值 上 KEYBOARDHIDDEN_NO( 值 为 1 ) .KEYBOARDHIDDEN | 
YES( 值 为 2)。 

G) 键盘 类 型 。 可 取 的 值 有 KEYBOARD_NOKEYS( 值 为 1)、KEYBOARD_QWERTY 
( 值 为 2)、KEYBOARD_12KEY( 值 为 3)。 

(4) 滚动 球 方式 。 可 取 的 值 有 NAVIGATION _NONAV( 值 为 1)、NAVIGATION_ 
DPAD ( 值 为 2)、NAVIGATION_TRACKBALL( 值 为 3).NAVIGATION_WHEEL( 值 为 4) 

(5) 触 屏 模式 。 可 取 的 值 有 TOUCHSCREEN_NOTOUCH( 值 为 1) TOUCHSCREEN_ 
STYLUS( 值 为 2)、TOUCHSCREEN_FINGER( 值 为 3) 。 

如 果 在 AndroidManifest. xml 文件 中 ,对 activity 标签 的 configChanges 属性 设置 了 多 个 
值 ,那么 onConfigurationChanged() 方 法 就 可 以 捕获 多 个 事件 。 例 如 ,在 AndroidManifest. 
xml 文件 中 有 如 下 属性 : android: configChanges = " orientation | keyboardHidden " . 则 在 
onConfigurationChanged() 方 法 中 有 如 下 代码 片段 。 


(GOverride 
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public void onConfigurationChanged( Configuration newConfig) { 
super. onConf igurationChanged( newConfig); 
//…… 基于 资源 值 更 新 UI 的 代码 
if (newConfig.orientation == Configuration. ORIENTATION LANDSCAPE) { 
//…… 对 不 同 的 屏幕 方向 做 出 处 理 的 代码 


} 

if (newConfig.keyboardHidden == Configuration.KEYBOARDHIDDEN NO) { 
//…… 对 键盘 可 见 做 出 处 理 的 代码 

} 


} 


下 面 通过 一 个 简单 案例 来 说 明 响 应 Configuration 的 变化 用 法 。 
【案例 11.4】 响应 屏幕 朝向 的 改变 ,并 给 出 变化 的 消息 提示 。 


【说 明 】 在 屏幕 上 加 一 个 背景 图 片 ,可 以 更 好 地 表现 屏幕 的 朝向 效果 ,并 且 让 某 些 控件 在 
初始 运行 时 不 可 见 , 能 更 好 地 体现 当 系统 设置 改变 后 ,不 用 执行 onCreate ) 方 法 ,而 是 执行 
onConfigurationChanged() 方 法 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 ConfigOrient 的 Android 项 目 。 其 应 用 程序 
名 为 Cfg_Orient, 包 名 为 cn. com. sgmsc. Ori, Activity 组 件 名 为 Cfg_OrientActivity。 


(2) 准备 图 片 。 将 作为 背景 图 片 的 文件 复制 到 res/drawable-mdpi 目录 中 。 
(3) 准备 字符 串 资 源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?» 

2 < resources > 

3 < string name = "hello"> Hello World, Cfg_OrientActivity!</string> 
4 < string name = "app_name"> Cfg_Orient </string> 

5 < string name = "btn"> 点 击 更 改 屏幕 朝向 </string> 

6 < string name = "et"> 当 前 屏幕 朝向 : </string> 

7 < string name = "orientP"»J [5] (PORTRAIT)«/string? 

8 < string name = "orientL" >$ [5] (LANDSCAPE) «/string? 

9 «/resources» 


(4) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf 一 8"?> 
2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:orientation = "vertical" 


4 android:layout width- "fill parent" 

5 android:layout height = "fill parent" 

6 android:background = " (2 drawable/bg" 

7 Es <! -- 声明 一 个 线性 布局 --> 
8 < Button 

9 android: id= "(à + id/btn" 

10 android:layout width- "fill parent" 

zt android:layout height = "wrap content" 

12 android:text = "(Qstring/btn" 

13 /> <! -- 声明 一 个 Button 控件 --> 
14 < EditText 

15 android:id- "@ + id/et" 

16 android:layout width- "fill parent" 

17 android: layout_height = "wrap_content" 


18 android:cursorVisible = "false" 
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19 android:text = "16sp" 
20 /> <! -- 声明 一 个 EditText 控件 --> 
21 </LinearLayout > 


(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Ori 包 下 的 Cfg OrientActivity. java X fF. 
并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. Ori; 


2 
3 import android.app. Activity; 

4 import android. content. pm. ActivityInfo; 

5 import android. content. res. Configuration; 
6 import android. os. Bundle; 

7 import android. view. View; 

8 import android. widget. Button; 

9 import android. widget. EditText; 

10 import android. widget. Toast; 


12 public class Cfg OrientActivity extends Activity ( 

13 EditText et; 

14  (QOverride 

15 public void onCreate(Bundle savedInstanceState) { // 重 写 onCreate( ) Jj ik 
16 super. onCreate(savedInstanceState); 

17  setContentView(R. layout. nain) ; // 设 置 当前 屏幕 

18 Button btn = (Button)findViewById(R. id. btn); 

19 et = (EditText)findViewById(R. id. et); 

20 et.setVisibility(View. GONE); 

21 btn. setOnClickListener(new View.OnClickListener() ( 


22 (QOverride 
23 public void onClick(View v) ( 
24 if(Cfg OrientActivity.this.getRequestedOrientation() == - 1)( 
// 判 断 是 否 可 以 获得 屏幕 方向 属性 
25 Tbast.makeText(Cfg_Orienthctivity.this，" 系 统 的 屏幕 方向 无 法 获取 !14"，Tbast. 
26 LENGTH LONG). show( ) ; 
27 
28 else( 
29 if(Cfg OrientActivity.this.getRequestedOrientation() == 
30 ActivityInfo. SCREEN ORIENTATION LANDSCAPE)( 
31 Cfg OrientActivity. this. setRequestedOrientation 
32 (ActivityInfo. SCREEN ORIENTATION PORTRAIT); 
33 i 
34 else if(Cfg OrientActivity.this.getRequestedOrientation() == 
35 ActivityInfo. SCREEN ORIENTATION PORTRAIT)( 
36 Cfg OrientActivity. this. setRequestedOrientation 
37 (ActivityInfo. SCREEN ORIENTATION LANDSCAPE); 
38 ) 
39 } 
40 } 
41 n; 
42 ] 


43 @Override 

44 public void onConfigurationChanged(Configuration newConfig) ( 

45 Toast.makeText(this，" 系 统 的 屏幕 方向 发 生 改 变 "，Toast. LENGTH LONG). show() ; 
46 updateEditText(); // 更 新 EditText 显示 的 内 容 
47 super. onConf igurationChanged(newConf ig) ; 
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48 ] 

49 public void updateEditText()( 

50 int ori = getRequestedOrientation(); // 获 取 屏 幕 朝向 
51 et. setText(getResources().getText(R. string.et)); 

52 et. setVisibility(View. VISIBLE); 

53 switch(ori){ // 判 断 屏幕 当前 朝向 
54 case ActivityInfo. SCREEN ORIENTATION PORTRAIT: 

55 et. append(getResources( ) . getText(R. string. orientP)); 

56 break; 

57 case ActivityInfo. SCREEN_ORIENTATION_LANDSCAPE : 

58 et. append(getResources().getText(R. string. orientL)); 

59 break; 

60 } 

6 ) 

62 ) 


(D 58 20 fr ERE Edit Text 不 显示 。 

@ 第 21—41 行 定义 按钮 的 OnClickListener 监听 。 在 onClick() 回 调 事件 中 ,首先 判断 
是 否 可 以 获得 requestedOrientation 属性 ,如 果 可 以 , 则 调用 setRequestedOrientation () 方 法 
改变 屏幕 的 朝向 。 

@ 第 44~48 行 ,定义 onConfigurationChanged(), 在 其 中 调用 自 定义 方法 updateEditText O 
(在 第 49 一 61 行 定义 ) 来 显示 屏幕 朝向 改变 消息 和 提示 信息 。 

(D 第 52 行 让 EditText 可 见 ,第 55,58 行 向 EditText 中 追加 字符 串 信 息 。 

(6) 添加 权限 属性 。 打 开 根 目录 下 的 AndroidManifest. xml 文件 ,添加 允许 修改 系统 设 
置 权 限 和 configChanges 属性 ,其 代码 如 下 。 

1 <?xml version= "1.0" encoding = "utf - 8"?» 

2 «manifest xmlns:android = "http: //schemas. android. com/apk/res/android" 
package = "cn. com. sgmsc. Ori" 
android:versionCode = "1" 


4 
5 android:versionName = "1. 0"> 

6 < uses - sdk android:minSdkVersion = "10" /> 
x 

8 


w 


< uses - permission android:name = "android. permission. CHANGE CONFIGURATION" /> 


9 « application android: icon = "@drawable/icon" android: label = "@string/app_name"> 
10 <activity android:name = ". Cfg_OrientActivity" 

nu android: label = "()string/app name" 

12 android: screenOrientation = "portrait" 

13 android:configChanges = "orientation"> 

14 < intent - filter > 

15 <action android:name = "android. intent. action. MAIN" /> 

16 < category android:name = "android. intent. category. LAUNCHER" /> 
17 </intent - filter > 

18 </activity> 

19 


20 </application> 
21 </manifest > 


【运行 结果 】 在 Eclipse 中 启动 一 个 Android 模拟 器 ,然后 运行 ConfigOrient 项 目 。 初 始 
运行 时 屏幕 显示 效果 如 图 11-11 所 示 ,这 时 单 击 “ 点 击 更 改 屏 幕 朝向 "按钮 ,屏幕 改 为 横向 显 
示 , 如 图 11-12 所 示 ; 青 次 单 击 “ 点 击 更 改 屏幕 朝向 "按钮 ,屏幕 还 原 为 纵向 显示 ,如 图 11-13 所 
示 。 请 注意 ,图 11-11 与 图 11-13 是 有 区 别 的 。 
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图 11-11 初始 运行 时 项 目 图 11-12 单 击 按钮 之 后 变 图 11-13 再 次 单 击 按钮 恢复 
的 界面 为 横向 显示 为 纵向 显示 


11.4.2 振动 设置 


手机 一 般 用 振 铃 和 振动 来 做 提醒 功能 。 在 应 用 程序 中 也 可 以 适当 地 运用 振动 特性 。 在 
Android 平台 下 不 仅 可 以 启动 手机 振动 ,还 可 以 设置 振动 的 周期 .持续 的 时 间 等 参数 。 

Vibrator 类 是 控制 管理 手机 振动 的 类 ,该 类 位 于 android. os 包 下 。 如 果 想 让 手机 启动 振 
动 , 需 要 创建 Vibrator 对 象 , 创 建 一 个 Vibrator 对 象 需要 调用 getSystemService() 方 法 ,如 : 


Vibrator vibrator = (Vibrator)getSystemService(Service. VIBRATOR SERVICE); 


在 创建 语句 中 ,使 用 了 Service. VIBRATOR. SERVICE 参数 ,这 需要 引入 android. app. 
Service 类 。 
启动 或 关闭 手机 振动 ,是 由 Vibrator 对 象 中 的 方法 实现 的 ,Vibrator 对 象 常用 的 方法 如 
表 11-3 所 示 。 


表 11-3 Vibrator 对 象 常用 方法 及 说 明 


5 È 2 K 说 明 
vibrate ( long [ ] pattern, pattern: 数组 ,该 数组 中 的 第 一 个 元 素 值 是 等 待 ” 根 据 指定 的 模式 进行 振动 
int repeat) 多 长 时 间 才 启动 振动 ,之 后 的 元 素 值 是 开启 和 关 

闭 振动 的 持续 时 间 , 单 位 以 毫秒 计 。 


repeat: 重复 次 数 , 当 其 为 一 1 时 ,表示 不 重复 ,只 
以 pattern 的 方式 运行 一 次 
vibrate(long milliseconds) milliseconds: 振动 持续 的 时 间 ,单位 以 毫秒 计 启动 振动 ,并 指定 持续 振 
动 的 时 间 
cancel() 关闭 振动 


从 表 中 可 看 到 ,启动 手机 振动 有 两 种 方式 ,一 种 是 指定 振动 模式 的 启动 , 另 一 种 是 指定 振 
动 持续 时 间 的 启动 。 例 如 ,指定 振动 模式 的 启动 代码 为 : 


vibrator.vibrate(new long[](1000,500,500,1000), - 1); 
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该 启动 模式 表示 ,第 一 个 参数 是 一 个 数组 , 它 定义 振动 模式 为 : 等 待 1s 启动 振动 ,持续 振 
动 0.5s 后 停止 ,停止 0. 5s 后 重新 启动 ,持续 振动 1s。 第 二 个 参数 为 一 1 ,表示 只 按 第 一 参数 指 
定 的 振动 模式 进行 一 次 ,不 重复 。 

关闭 振动 ,使 用 cancel() 方 法 即 可 。 

最 后 ,请 读者 记 住 ,要 使 用 振动 应 用 开发 ,必须 在 AndroidManifest. xml 文件 中 添加 声明 
振动 的 权限 。 代 码 如 下 : 


< uses - permission android:name = "android. permission. VIBRATE" /> 


11.4.3. 音量 调节 


一 些 Android 应 用 会 自 带 背景 音乐 ,例如 游戏 或 者 一 款 书 本 阅读 器 。 那 么 就 需要 有 调节 
声音 大 小 或 者 改变 声音 模式 的 控制 。 手 机 音量 调节 由 AudioManage 类 实现 ,该 类 位 于 
android, media 包 下 ,该 类 中 包含 很 多 对 声音 模式 和 音量 控制 的 方法 。 常 用 的 对 音量 进行 控制 
的 方式 如 表 11-4 所 示 。 


表 11-4 AudioManage 类 常用 的 方法 及 说 明 


方 ”法 2 数 说 M 
adjustStreamVolume(int stream Type, streamType: 声音 类 型 ; 调整 指定 声音 类 型 的 音量 
int direction, int flags) direction; 调整 音量 的 方向 ; 

flags: 可 选 的 标志 位 
setMode(int mode) mode: 声音 模式 设置 声音 模式 
setRingerMode(int ringerMode) ringerMode: 铃声 模式 设置 铃声 模式 
setStreamMute (int streamType， streamType: 声音 类 型 ; 设置 指定 类 型 的 声音 是 否 需 
boolean state) state; 是 否 使 该 类 型 声音 静音 的 标志 位 ”要 静音 


其 中 ,参数 streamType, 声 音 类 型 可 取 值 有 STREAM AI ALARM,STREAM DTMF, 
STREAM MUSIC,STREAM NOTIFICATION, STREAM RING,STREAM SYSTEM 和 
STREAM VOICE CALL; 参数 direction ,调整 音量 的 方向 可 取 值 有 ADJUST. LOWER, 
ADJUST RAISE 和 ADJUST SAME; 参数 flags, 可 选 的 标志 位 可 取 值 有 FLAG_ALLOW-_ 
RINGER_MODES、FLAG_PLAY_SOUND、FLAG_REMOVE_SOUND_AND_VIBRATE、 
FLAG SHOW UI fil FLAG VIBRATE ; 参数 mode, 声 音 模 式 可 取 值 有 NORMAL, RINGTONE 
和 IN CALL; 参数 ringerMode, 铃 声 模式 可 取 值 有 RINGER_MODE_NORMAL RINGER_ 
MODE, SILENT 和 RINGER_MODE_VIBRATE。 

播放 音乐 的 应 用 项 目 ,其 声音 资源 文件 一 般 都 存放 在 res 目录 下 的 raw 目录 下 。 使 用 
AudioManager 进行 音量 控制 ,有 下 列 几 段 关 键 代 码 。 

(1) AudioManager 对 象 的 创建 和 音量 控制 。 


i // 音 量 控 制 , 初 始 化 定义 

2 AudioManager mAudioManager = (AudioManager) getSystemService(Context.AUDIO SERVICE); 
3 // 最 大 音量 

4 int maxVolume = mAudioManager.getStreamMaxVolume(AudioManager. STREAM MUSIC); 

5 // 当 前 音量 

6 int currentVolume = mAudioManager.getStreamVolume(AudioManager.STREAM MUSIC); 
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(2) 直接 控制 音量 的 大 小 。 


1 if(isSilent)( 

2  mhudioManager. setStreanVolume(AudioManager. STREAM MUSIC, 0, 0); 

3 }else{ 

4 mAudioManager. setStreamVolume(AudioManager. STREAM MUSIC, tempVolume, 0); 


/ /'cenpVolune 为 音量 绝对 值 
5] 
(3) 以 步 长 为 单位 逐 增 或 逐 减 地 控制 音量 ,并 弹出 系统 默认 音量 控制 条 。 
1 // 降 低音 量 , 调 出 系统 音量 控制 
2 if(flag == 0){ 
3 mAudioManager. adjustStreamVolume(AudioManager. STREAM MUSIC, AudioManager. ADJUST LOWER, 
4 AudioManager.FX FOCUS NAVIGATION UP); 
5] 
6 // 增 加 音量 , 调 出 系统 音量 控制 
7 elseif(flag == 1)( 
8 mAudicManager. adjustStreamVolume(AudioManager. STREAM MUSIC, AudioManager. ADJUST RAISE, 
9 AudioManager.FX FOCUS NAVIGATION UP); 
10 ) 


11.4.4. 获取 手机 信息 


在 11.2 节 中 提 过 的 TelephonyManager 类 ,不 仅 可 以 对 电话 进行 控制 ,还 可 以 通过 
TelephonyManager 对 象 获取 手机 卡 及 电信 和 网络 等 信息 。 


1. TelephonyManager 类 简介 


TelephonyManager 类 位 于 android. telephony 包 下 ,该 类 提供 了 一 系列 用 于 访问 与 手机 
通信 相关 的 状态 和 信息 的 get…() 方 法 。 

关于 手机 通信 方面 的 信息 如 下 。 

(D IMEI(International Mobile Equipment Identity, 国 际 移 动 装 备 辨识 码 ) ,由 15 位 数字 
组 成 ,与 每 台 手 机 一 一 对 应 ,而 且 该 码 是 全 世界 唯一 的 。 

(2) IMSI(International Mobile Subscriber Identity, 国 际 移动 用 户 识 别 码 ) ,由 15 位 码 组 
成 ,其 结构 如 下 : MCCHMNC+MSIN, 

(3) MCC 是 移动 国家 码 (三 位 ) 。 

(4) MNC 是 移动 网 络 码 (两 位 )。 

(5) MSIN 是 身份 手机 用 户 号 (10 位 ) 。 

如 果 要 获取 手机 上 的 相关 信息 ,首先 要 创建 TelephonyManager 对 象 实例 ,其 创建 方法 与 
11.2 节 中 介绍 的 一 样 : Context. getSystemService( Context. TELEPHONY_SERVICE)。 并 
且 需 要 在 AndroidManifest. xml 中 添加 读 取 手机 信息 的 权限 : 


< uses - permission android:name = "android. permission. READ PHONE STATE"/» 
下 面 通 过 一 个 案例 来 说 明 如 何 获取 手机 的 通信 状态 和 信息 。 
2. 获取 手机 信息 


【案例 11.5】 获取 手机 当前 的 SIM 卡 、. 电 信 网 络 、 运 营 商 .IMEI 和 IMSI 等 信息 。 
【说 明 】 在 案例 中 介绍 TelephonyManager 常用 的 get...() 方 法 。 
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【开发 步骤 及 解析 】 
CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 MobileInfos 的 Android 项 目 。 其 应 用 程序 名 


为 Mobil_Infos, 包 名 为 cn. com. sgmsc. MobileInfo, Activity 组 件 名 为 Mobil_InfosActivity。 


Java 


(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf - 8"?> 

2 <ScrollView xmlns:android = "http: //schemas. android. con/apk/res/android" 

3 android: layout_width = "fill_parent" 

4 android: layout_height = "wrap_content"> 

5 < LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
6 android:orientation = "vertical" 

7 android:layout width- "fill parent" 

8 android:layout height = "fill parent" 

9 android: padding = "20px" 


10 > 

11 

12 < TextView android:id= "@ + id/title" 

13 android:layout_width = "fill parent" 
14 android:layout height = "wrap content" 
15 android:textSize = "20sp" 

16 android:paddingBottom = "8dip" 

17 android:text = "" /> 

18 

19 X TextView android:id- "(à) + id/info" 

20 android:layout width- "fill parent" 
21 android:layout height = "wrap content" 
22 android:text = "" /> 

23 

24 «/LinearLayout > 


25 «/ScrollView» 


(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. MobileInfo 包 下 的 Mobil. InfosActivity. 
文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. MobileInfo; 


E 

2 

3 import android. app. Activity; 

4 import android. content. Context; 

5 import android. os. Bundle; 

6 import android. telephony. TelephonyManager; 
7 import android. widget. TextView; 

8 
9 


public class Mobil InfosActivity extends Activity { 
11 TextView info,title; 


13 @Override 

14 public void onCreate(Bundle savedInstanceState) { 
起 super. onCreate( savedInstanceState); 

16 setContentView(R. layout. main); 

3 title = (TextView) findViewById(R. id. title); 

18 title. setText(" 运 营 商 信息 : " ); 

19 info- (TextView) findViewById(R. id. info); 
20 info.setText(load data(this)); 
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21 } 

22 

23 private static String load_data(Context cis) { 

24 // BH TelephonyManager 对 象 的 引用 

25 TelephonyManager tm = (TelephonyManager) cis.getSystemService(Context. TELEPHONY SERVICE); 
26 String str = ""; 

21 str += "设备 编号 (IMEI) = ”+ tm.getDeviceld() + "An"; //IMEI: 国际 移动 设备 辨识 码 
28 str += "设备 软件 版 本 : " + tm. getDeviceSoftwareVersion() + "in"; 

29 str += "本 机 号 码 : " + tm.getLinelNumber() + "in"; 

30 str "网 络 国 别 : ”+ tm.getNetworkCountryIso() + "n"; 

31 str += "网 络 运营 商 代 号 : ”+ tm. getNetworkOperator() + "Wn"; 

32 str += "网 络 运营 商 名 称 : ”+ tm. getNetworkOperatorName() + "Wn"; 

33 str :" + tm.getNetworkType() + "Wn"; 

34 str += "手机 制式 : ”+ tm.getPhoneType() + "\n"; 

35 str += "SIM 卡 国 别 : ”+ tm.getSimCountryIso() + "An"; 

36 str += "SIM 卡 运营 商 代号 : " + tm.getSimOperator() + "Wn"; 

37 str += "SIM 卡 运营 商 名 称 : " + tm.getSimOperatorName() + "An"; 

38 str += "SIM 卡 序列 号 : " + tm.getSimSerialNumber() + "An"; 

39 str += "SIM 卡 状态 : ”+ tm.getSimState() + "An"; 

40 str += "语音 信箱 号 码 : " + tm. getVoiceMailNumber() + "\n\n"; 

41 // 获 取 国际 移动 用 户 识别 码 IMSI 的 相关 信息 : 

42 str += "国际 移动 用 户 识别 码 IMSI 相关 信息 : Ww"; 

43 str += "SubscriberId(IMSI): " + tm.getSubscriberId() + "Wn"; 

44 int mcc = cis.getResources().getConfiguration().mcc; 

45 int mnc = cis.getResources().getConfiguration().mnc; 

46 str *- "IMSI MCC (Mobile Country Code): " * String.valueOf(mcc) * "An"; 
47 str += "IMSI MNC (Mobile Network Code): " + String.valueOf(mnc) + "An"; 
48 return str; 

49 ] 

50 

51] 


第 26—47 行 , 为 字符 串 变 量 str 不 断 追 加 字符 信息 ,其 信 
息 来 自 于 get() 方 法 。 

(4) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml 
文件 ,并 在 二 manifest 二 标签 中 加 入 权限 : 

<uses - permission android: name = "android. permission. READ_ 

PHONE_STATE" /> 

【运行 结果 】 在 Eclipse 中 启动 一 个 Android 模拟 器 , 运 
f1 MobileInfos 项 目 , 屏 幕 显示 效果 如 图 11-14 所 示 。 


11.4.5 获取 手机 电池 电量 


获取 手机 的 电池 电量 信息 是 应 用 程序 中 经 常 需要 的 应 
用 ,在 Android 系统 中 ,从 系统 中 获取 手机 电池 电量 发 生变 化 


图 11-14 MobileInfos 项 目的 
的 信息 通常 是 通过 Intent 广播 来 实现 的 ,这 个 Intent 常用 的 运行 结果 


Action 有 Intent. ACTION_BATTERY_CHANGED( 电 池 电 
量 发 生 改 变 时 )、Intent. ACTION. BATTERY | LOW (电池 电量 达到 下 限时 ) 和 Intent. 


ACTION BATTERY OKAY (电池 电量 从 低 恢复 到 高 时 )。 并 且 需 要 为 应 用 程序 注册 
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BroadcastReceiver 组 件 , 以 便 在 电池 电量 发 生变 化 后 ,通过 该 BroadcastReceiver 组 件 捕 获 
ACTION_BATTERY_CHANGED 动作 ,接收 到 系统 发 出 相应 的 广播 ,来 得 到 电池 电量 信息 ,并 
进行 应 用 程序 需要 的 相应 处 理 。 如 果 要 停止 监测 手机 电池 电量 时 ,只 需 注销 BroadcastReceiver 
组 件 即 可 。 

下 面 通过 一 个 简单 案例 来 说 明 电 量 提 示 应 用 。 

【案例 11.6】 通过 BroadcastReceiver 获取 手机 电池 电量 信息 。 

【说 明 】 在 案例 中 使 用 一 种 开关 按钮 控件 ToggleButton ,用 于 监测 或 停止 监测 手机 电池 
的 电量 ,该 控件 位 于 android. widget 包 下 。ToggleButton 只 能 有 选中 和 未 选中 两 种 状态 ,并 
且 需 要 为 不 同 的 状态 设置 不 同 的 显示 文本 ,属性 android: textOff 为 未 选中 显示 文本 ,属性 
android:textOn 为 选中 显示 文本 。 

本 例 中 ,监测 或 停止 监测 手机 电池 电量 是 由 注册 或 注销 BroadcastReceiver 组 件 控制 ,所 
以 在 程序 中 需要 动态 控制 BroadcastReceiver 组 件 的 注册 和 注销 ,而 不 能 在 AndroidManifest. xml 
文件 中 注册 。 

【开发 步骤 及 解析 】 

COD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 BatteryInfo 的 Android 项 目 。 其 应 用 程序 名 
为 BatteryInfo, 包 名 为 en. com. sgmsc. Batt, Activity 组 件 名 为 BatteryInfoActivity。 

(2) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 ,代码 如 下 所 示 。 

<?xml version = "1.0" encoding = "utf 一 8"?> 
< LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
android:orientation = "vertical" 


1 

2 

3 

4 android:layout_width = "fill_parent" 

5 android:layout_height = "fill_parent"> 
6 
7 
8 


< ToggleButton android:id= "(à + id/tbtn" 
android:layout width- "fill parent" 


9 android:layout height = "wrap content" 

10 android:textOn = "停止 获取 电量 信息 " 

i android: textOff = "获取 电量 信息 "” /> 

12 

13 < TextView android:id- "(9 + id/tv" 

14 android:layout width- "fill parent" 

15 android:layout height - "wrap content" /» 
16 


17 «/LinearLayout» 


(3) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Batt 包 下 的 BatteryInfoActivity. java X 
件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgnsc. Batt; 


import android. app. Activity; 

import android. content. BroadcastReceiver; 
import android. content. Context; 

import android. content. Intent; 

import android. content. IntentFilter; 
import android. os. Bundle; 

import android. widget. CompoundButton; 

10 import android. widget. TextView; 
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11 import android. widget. ToggleButton; 
12 import android. widget. CompoundButton. OnCheckedChangeListener; 


13 


14 public class BatteryInfoActivity extends Activity { 


15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
21 
28 
29 
30 
31 
32 


33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 } 


private ToggleButton tb = null; 
private TextView tv = null; 
private BatteryReceiver battreceiver = null; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. main); 


battreceiver - new BatteryReceiver(); // 创 建 BroadcastReceiver 组 件 对 象 
tv = (TextView)findViewById(R. id. tv); 

tb = (ToggleButton) f indViewById(R. id. tbtn) ; 

tb. setOnCheckedChangeListener(new OnCheckedChangeListener( ) ( 


public void onCheckedChanged(CompoundButton compoundButton, boolean isChecked) ( 

if(isChecked)( // 获 取 电 池 电 量 
IntentFilter battfilter = new IntentFilter(Intent. ACTION BATTERY CHANGED); 
registerReceiver(battreceiver, battfilter); 

// 注 册 BroadcastReceiver 

Jelse ( // 停 止 获取 电池 电量 
unregisterReceiver(battreceiver) ;// 注 销 BroadcastReceiver 
tv.setText(null); 


ni 
) 


private class BatteryReceiver extends BroadcastReceiver( 


(QOverride 

public void onReceive(Context context, Intent intent) ( 
int current = intent.getExtras().getInt("level"); // 获 得 当前 电量 
int total = intent. getExtras(). getInt("scale"); // 获 得 总 电量 
int percent = current * 100/total; 


tv. setText(" 现 在 的 剩余 电量 是 : " + percent+ "% ,"); 


(D 第 24 行 ,创建 BatteryReceiver 对 象 battreceiver, 这 个 BatteryReceiver 类 继承 自 
BroadcastReceiver; 第 31 行 创 建 一 个 IntentFilter 对 象 battfilter, 其 action 为 Intent. ACTION _ 
BATTERY CHANGED; 第 32 行 注册 BroadcastReceiver。 当 battreceiver 接收 到 系统 传 过 来 
的 电池 电量 信息 时 ,就 执行 这 个 BroadcastReceiver 的 onReceive() 方 法 。 

© 第 41 一 50 行 定义 了 BatteryReceiver 类 ,其 中 重 写 了 onReceive() 方 法 。 在 该 方法 中 取 
得 当前 的 剩余 电量 ,并 把 它 显 示 在 屏幕 上 。 

【运行 结果 】 在 Eclipse 中 启动 一 个 Android 模拟 器 ,运行 BatteryInfo 项 目 ,初始 运行 界 
面 如 图 11-15 所 示 , 单 击 “获取 电量 信息 ?按钮 后 ,在 按钮 下 方 显示 剩余 电量 ,如 图 11-16 所 示 。 
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E 自 oso 


Batteryinfo 


获取 电量 信息 


图 11-15 运行 BatteryInfo 项 目的 初始 界面 


ES] 


11-16 单 击 “获取 电量 信息 ”按钮 之 后 


11.5 手机 传感器 开发 


所 谓 传感器 就 是 能 够 探测 如 光 、 热 \ 温 度 、 重 力 、 方 向 等 的 功能 。Android 系统 的 一 大 亮点 
之 一 就 是 对 传感器 的 应 用 ,如 水 平 仪 . 指 北 针 、 计 步 器 等 。 

Android 常用 的 传感器 包括 加 速度 传感器 (Accelerometer) .方向 传感器 (Orientation) Ré 
场 传感器 (Magnetic Field) ,温度 传感器 (Temperature) ,环境 光 传 感 器 (Light) .距离 传感器 
(Proximity) ,压力 传感器 (Pressure) 、 条 码 传 感 器 (Barcode) ,Android SDK 2. 3 平台 新 增 了 更 
多 类 型 传感器 的 支持 ,包括 : BERAY (gyroscope) 、 重 力 感 应 器 (gravity) .旋转 矢量 (rotation 
vector) 和 线性 加 速 器 (linear acceleration) 等 。Android 用 SensorManager 来 管理 这 些 传 
感 器 。 


11.5.1 传感器 管理 器 


1. SensorManager 类 
SensorManager 类 位 于 android. hardware 包 下 ,该 类 是 用 来 管理 传感器 的 。 在 
SensorManager 中 ,传感器 的 类 型 由 常量 来 表示 。 常 用 的 常量 如 表 11-5 所 示 。 
X 11-5 SensorManager 中 常用 的 传感器 类 型 常量 
类 型 常量 内 部 值 描 述 


Sensor. TYPE_ACCELEROMETER 1 加 速度 传感器 
Sensor. TYPE_MAGNETIC_FIELD 2 磁场 传感器 
Sensor. TYPE_ORIENTATION 3 方向 传感器 
Sensor. TYPE_GYROSCOPE 4 陀螺 仪 传感器 
Sensor. TYPE_LIGHT 5 环境 光照 传感器 
Sensor. TYPE_PRESSURE 6 压力 传感器 
Sensor. TYPE_TEMPERATURE 温度 传感器 
Sensor. TYPE_PROXIMITY 8 距离 传感器 


SensorManager 类 的 主要 方法 有 下 列 几 个 。 
(1) 获取 某 种 传感器 的 默认 传感器 方法 : 


Sensor defaultGyroscope = sensorManager. getDefaultSensor(Sensor. TYPE GYROSCOPE); 
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(2) 获取 某 种 传感器 的 列表 方法 : 

List< Sensor» pressureSensors = sensorManager.getSensorList(Sensor. TYPE PRESSURE); 

(3) 获取 所 有 传感器 的 列表 方法 : 

List< Sensor > allSensors = sensorManager.getSensorList(Sensor.TYPE ALL); 

对 于 某 一 个 传感器 , 它 通过 get 方法 获取 具体 信息 。 常 用 的 get() 方 法 如 表 11-6 所 示 。 
表 11-6 ”传感器 使 用 的 get() 方 法 及 说 明 


5 È 描 述 5 d 描 述 
getMaximumRange() 最 大 取 值 范围 getType() 传感器 类 型 
getName() 设备 名 称 getVentor() 设备 供应 商 
getPower() 功率 getVersion() 设备 版 本 号 


getResolution() 


2. SensorEventListener 接口 


SensorEventListener 是 一 个 接口 ,是 在 传感器 值 实 时 更 改 时 ,和 希望 接收 更 新 的 类 要 实现 的 接 
HO., SensorEventListener 接口 位 于 android. hardware 包 下 , 它 是 开发 传感器 应 用 最 主要 的 工作 。 
应 用 程序 实现 该 接口 来 监视 硬件 中 一 个 或 多 个 可 用 传感器 。 实 现 SensorEventListener 接口 主要 
需要 实现 以 下 两 个 方法 。 

1) onAccuracyChanged(int sensor. int accuracy) 

该 方法 在 传感器 的 精确 度 发 生变 化 时 调用 ,参数 包括 两 个 整数 : 一 个 表示 传感器 , 另 一 个 
表示 该 传感器 新 的 准确 度 值 。SensorManager 提供 了 三 种 精确 度 , 由 高 到 低 分 别 为 : 
SENSOR STATUS ACCURACY HIGH,SENSOR STATUS ACCURACY MEDIUM 和 
SENSOR STATUS ACCURACY LOW, 

2) onSensorChanged(SensorEvent event) 

该 方法 在 传感器 的 数据 发 生变 化 时 调用 ,该 方法 只 有 一 个 SensorEvent 类 型 的 参数 
event, 其 中 SensorEvent 类 有 一 个 values 变量 非常 重要 ,该 变量 的 类 型 是 float[ ]。 但 该 变量 
最 多 只 有 三 个 元 素 , 而 且 根 据 传感器 的 不 同 ,values 变量 中 元 素 所 代表 的 含义 也 不 同 。 有 些 传 
感 器 只 提供 一 个 数据 值 , 另 一 些 则 提供 三 个 浮 点 值 。 如 方向 和 加 速度 传感器 都 提供 三 个 数据 
值 。 开 发 传感器 应 用 的 主要 业务 代码 应 该 放 在 这 里 执行 ,如 读 取 数 据 并 根据 数据 的 变化 进行 
相应 的 操作 等 。 

在 Android 1.5 API Level 3 以 前 ,感应 器 应 用 编程 使 用 的 是 SensorListener 接口 ,现在 被 
SensorEventListener 所 代替 。 它 们 都 是 注册 一 个 Listener, 其 主要 区 别 在 于 onSensorChanged() 方 
法 的 参数 上 ,SensorListener 接口 内 使 用 方法 onSensorChanged (int sensor, float[] values) 。 


11.5.2 Android 常用 传感器 
1. 加 速度 传感器 


加 速度 传感器 (Accelerometer) 主要 感应 手机 的 运动 ,在 注册 了 传感器 监听 器 后 加 速度 传 
感 器 主要 捕获 三 个 参数 values[0] values[1] ,values[2] .以 m/s? 为 单位 。 
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values[0]: 空间 坐标 系 中 X 轴 方 向 上 的 加 速度 减 去 重力 加 速度 在 X 轴 上 的 分 量 。 
values[1]: 空间 坐标 系 中 X 轴 方 向 上 的 加 速度 减 去 重力 加 速度 在 Y 轴 上 的 分 量 。 
values[2]: 空间 坐标 系 中 X 轴 方 向 上 的 加 速度 减 去 重力 加 速度 在 Z 轴 上 的 分 量 。 


2. 方向 传感器 


方向 传感器 (Orientation) 主要 感应 手机 方位 的 变化 ,其 每 次 读 取 的 都 是 静态 的 状态 值 ,在 
注册 了 传感器 监听 器 后 方向 传感器 主要 捕获 三 个 参数 values[0], values[ 1], values[ 2]. 4) 9l 
代表 手机 沿 Yaw 轴 、Pitch 轴 和 Roll 轴 方 向 转 过 的 角度 。 

Yaw 轴 , 是 三 个 方向 轴 中 唯一 不 变 的 轴 , 其 方向 总 是 竖 直 向 上 ,和 空间 坐标 系 中 的 Z 轴 是 
等 同 的 ,也 就 是 重力 加 速度 g 的 反方 向 。 

Pitch 轴 ,其 方向 依赖 于 手机 沿 Yaw 轴 的 转动 情况 , 即 当 手机 沿 Yaw 轴 转 过 一 定 角度 后 ， 
Pitch 轴 也 相应 围绕 Yaw 轴 转 过 相同 的 角度 。Pitch 轴 的 位 置 依赖 于 手机 沿 Yaw 轴 转 过 的 角 
度 , 好 比 Yaw 轴 和 Pitch 轴 是 两 个 焊 死 在 一 起 成 90^ 3e fü f dit o 

Roll 轴 ,其 方向 虽然 依赖 于 手机 沿 Yaw 轴 和 Pitch 轴 转 动 的 情况 ,但 是 Roll 轴 的 确定 并 
不 复杂 ,Roll 轴 与 手机 之 间 的 相对 关系 是 固定 的 。 其 总 是 沿 着 手机 屏幕 长 边 正方 向 ,是 与 手 
机 绑 定 的 。 

三 个 方向 轴 的 关系 如 图 11-17 所 示 。 


Yaw Roll 


0 Roll 


0 Pitch 


[09 


图 11-17. Yaw,Pitch, Roll 方向 轴 在 手机 上 的 位 置 


Pitch 


3. 磁场 传感器 


磁场 传感器 (Magnetic Field) 主要 用 于 感应 周围 的 磁感应 强度 ,注册 监听 器 后 其 主要 捕获 
三 个 参数 : valuesL0] ,values[1] ,values[2]。 三 个 参数 分 别 代表 磁感应 强度 在 空间 坐标 系 中 
三 个 方向 轴 上 的 分 量 ,单位 为 微 特 拉 斯 (xT)。 通 过 该 传感器 可 以 开发 出 指 北 针 、 罗 盘 等 磁场 
应 用 。 


4. 温度 传感器 


温度 传感器 (Temperature ) 用 于 感应 周围 的 温度 ,注册 监听 器 后 只 捕获 一 个 参数 , values[0]。 
该 参数 代表 当前 的 温度 。 通 过 运用 温度 传感器 可 以 开发 出 手机 温度 计 等 应 用 。 


5. 环境 光 传 感 器 
环境 光 传感器 (Light) 用 于 感应 周围 的 光 强 ,注册 监听 器 后 只 捕获 一 个 参数 . values[0]。 
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该 参数 代表 周围 的 光照 强度 ,单位 为 勒 克 斯 (lux) 。 
6. 距离 传感器 


距离 传感器 (Proximity) 用 于 感应 周围 靠近 的 物体 ,注册 监听 器 后 只 捕获 一 个 参数 ， 
values[0]。 该 参数 代表 传感器 的 物体 距离 ,以 厘米 (cm ) 为 单位 。 


11.5.3 传感器 应 用 的 开发 
1. 开发 前 的 准备 工作 


在 Android ge SensorSimulator 工具 软件 ,这 个 工 
具 是 一 个 开源 免费 的 程序 , 它 可 以 模拟 加 速度 方向、 磁场 温度、 环境 光 、 压 力 等 传感器 的 场 
景 。 其 下 载 网 址 为 http://code. google. com/p/openintents/wiki/SensorSimulator, Jy T fË 


支持 在 SDK 2.3 版 本 上 运行 ,本 书 下 载 的 文件 是 sensorsimulator-2. 0-rcl. zip 压缩 包 。 下 载 
完成 后 还 需要 做 一 些 工 作 ,以 便 用 户 能 使 用 SensorSimulator 工具 软件 。 接 下 来 的 操作 步骤 


如 下 。 

CD 将 下 载 的 sensorsimulator-2. 0-rcl. zip 文件 解压 到 磁盘 上 ,在 该 解压 文件 夹 的 bin X 
件 夹 下 可 以 看 到 相应 的 . jar 包 和 . apk 包 文 件 。 本 书 是 将 其 解压 在 E:\sensorsimulator-2. 0 
rcl 文件 夹 下 。 

(2) 在 Eclipse 中 启动 模拟 器 。 

(3) 向 模拟 器 安装 SensorSimulator。 首 先 使 用 "cmd” 进 入 命令 行 状态 ,输入 “E:” 并 回 车 ,将 
当前 盘 符 设 为 下 盘 ; 然后 输入 cd sensorsimulator-2. 0-rclVbin" p S ,将 E:\ sensorsimulator-2. 0 
rcl\bin 文件 夹 设置 为 当前 文件 夹 ; 在 此 文件 夹 提 示 符 下 输入 命令 “adb install SensorSimulator 
2. 0-rcl. apk”, 如 tsm 完 这 些 命 令 后 ,出现 “Success” 信 息 , 说 明 已 经 为 开启 的 模拟 器 安装 好 
SensorSimulator ,如 图 11-18 所 示 。 

这 时 可 以 在 模拟 器 的 应 用 程序 图 标 中 看 到 SensorSimulator 应 用 程序 ,如 图 11-19 所 示 。 


m EA: CA Windows systemi2 Vom 


latorSettings-2.0-rci -apk 


inulator-2.8-rci bin), 


图 11-18 在 命令 行 状态 向 模拟 器 安装 SensorSimulator 的 过 程 图 11-19 在 模拟 器 的 应 用 程序 列表 中 
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2. 开发 流程 


在 模拟 器 上 开发 传感器 应 用 需要 借助 于 SensorSimulator 工具 ,所 以 其 开发 流程 要 比 一 般 
的 应 用 多 一 些 操作 步骤 。 

开发 一 个 传感器 应 用 项 目 , 主 要 流程 如 下 。 

D 新 建 一 个 应 用 项 目 

在 Eclipse 中 新 建 一 个 传感器 应 用 项 目 。 创 建 过 程 与 其 他 的 应 用 项 目 一 样 。 

2) 为 该 项 目 添加 JAR 包 

为 该 项 目 添加 JAR 包 是 开发 传感器 应 用 项 目 必须 做 的 ,其 他 的 应 用 项 目 不 用 做 。 具 体操 
作 步 又 如 下 。 

(1) 在 Eclipse 的 Project Explorer 中 选择 该 项 目 , 然后 右 击 ,在 弹出 菜单 中 选择 
Properties 菜单 项 ,如 图 11-20 所 示 。 
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图 11-20 选择 该 项 目的 Properties 菜单 项 


(2) 进入 Properties for SensorDemo 窗口 , 先 在 左 侧 选 择 Java Build Path 选项 ,再 在 右 侧 
视窗 中 选择 Libraries 选项 卡 , 然 后 单 击 Add External JARs... 按 钮 ,打开 “文件 选择 ”对 话 框 ， 
在 SensorSimulator 的 解压 文件 夹 的 lib 子 文件 夹 下 选择 sensorsimulator-lib-2. 0-rcl. jar XC 
件 , 单 击 “ 打 开 ” 即 可 ,如 图 11-21 所 示 。 

(3) 单 击 OK 按钮 , 即 完 成 该 项 目的 JAR 包 添加 。 

3) 项 目 资源 素材 准备 

如 果 该 项 目 需要 使 用 到 一 些 图 片 ,图标 声音 音效 ,文本 字符 串 或 颜色 等 资源 ,需要 预先 准 
备 好 ,存放 到 项 目的 指定 目录 中 。 
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1121 为 项 目 添加 了 一 个 JAR 包 


4) 项 目 编码 开发 

Android 平台 下 传感器 应 用 的 开发 通过 监听 器 机 制 来 实现 ,如 果 要 针对 某 一 种 或 多 种 传 
感 器 开发 应 用 ,主要 的 步骤 如 下 。 

(1) 创建 SensorManager 对 象 。 

在 模拟 器 中 运行 ,使 用 下 列 代码 创建 SensorManager 对 象 : 

SensorManagerSimulator mySensorManager = SensorManagerSimulator. getSystemService(this, SENSOR_ 


SERVICE); 
mySensorManager. connectSimulator(); 


在 真 机 中 运行 ,使 用 下 列 代码 创建 SensorManager 对 象 : 
SensorManager mySensorManager = (SensorManager)getSystemService(SENSOR SERVICE); 


(2) 实现 SensorEventListener 接口 。 
在 实现 SensorEventListener 接口 中 需要 实现 onAccuracyChanged(int sensor, int accuracy) fl 
onSensorChanged(SensorEvent event) 两 个 方法 。 其 主要 的 代码 段 如 下 : 


private final SensorEventListener mSensorEventLisener = new SensorEventListener (){ 
@Override 
public void onAccuracyChanged( int sensor, int accuracy) { 
// 加 入 传感器 的 精确 度 发 生变 化 时 的 处 理 代码 
public void onSensorChanged(SensorEvent event) { 


// 加 入 传感器 的 数据 发 生变 化 时 的 处 理 代码 
) 
(3) 注册 与 注销 SensorListener, 
开发 完 SensorListener 之 后 , 剩 下 的 工作 就 是 在 程序 的 适当 位 置 注册 监听 和 取消 监听 了 。 
在 这 里 调用 步骤 (1) 中 获得 的 SensorManager 对 象 的 registerListener() 方 法 来 注册 监听 器 ， 
其 接收 的 参数 为 监听 器 对 象 .传感器 类 型 以 及 传感器 事件 传递 的 频 度 。 
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注销 SensorListener 时 调用 SensorManager 的 unregisterListener() 方 法 ,一 般 来 讲 在 编 
程 中 ,注册 和 注销 的 方法 应 该 成 对 出 现 , 如 果 在 Activity 的 onResume O ) 方 法 中 注册 
SensorListener 监听 ,就 应 该 在 onPause() 方 法 中 注销 。 

(4) 添加 权限 。 

在 AndroidManifest. xml 文件 中 添加 权限 : 


< uses - permission android:name = "android. permission. INTERNET" /> 


5) 运行 传感器 项 目 
在 模拟 器 上 运行 项 目前 ,必须 启动 SensorSimulator 工具 。 其 操作 方法 是 : 在 SensorSimulator 
的 解压 文件 夹 的 bin 文件 夹 下 ,运行 sensorsimulator-2. 0-rcl. jar 文件 ,如 图 11-22 所 示 。 
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图 11-22 SensorSimulator 工具 软件 界面 


然后 在 模拟 器 上 运行 应 用 项 目 。 
在 SensorSimulator 窗口 的 左上 角 区 域 ,通过 鼠标 拖 动 操作 ,可 以 模拟 手机 的 方向 位置 的 
旋转 或 移动 ,从 而 可 以 看 到 模拟 器 中 运行 项 目的 同步 变化 效果 。 


3. 传感器 应 用 案例 


【案例 11.7】 实时 获取 手机 支持 的 各 类 传感器 的 数据 信息 。 

【说 明 】 在 案例 中 获取 的 一 些 常 用 传感器 的 数据 ,这 些 数据 也 可 以 在 SensorSimulator 窗 
口中 看 到 。 

【开发 步骤 及 解析 】 

CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 SensorDemo 的 Android 项 目 。 其 应 用 程序 名 
为 SensorDemo, 包 名 为 cn. com. sgmsc. Sensor. Activity 组 件 名 为 SensorDemoActivity。 
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(2) 添加 JAR 包 。 为 该 项 目 添加 JAR 包 。 
CD 准备 字符 串 资源 。 编 写 res/values 目录 下 的 strings. xml 文件 ,代码 如 下 所 示 。 


1 <?xml version = "1.0" encoding = "utf - 8"?> 

2 «resources? 

3 < string name = "hello"» Hello World, SensorDemoActivity!«/string» 
4 < string name = "app name"» SensorDemo </ string > 

5 Accelerometer"> 加 速度 传感器 : «/string» 

6 < string name = "LinearAcceleration"> 线 性 加 速 器 : </string> 
7 

8 

9 


< string name = 


< string name = "Gravity"> 重 力 传感器 : «/string» 
< string name = "Magnetic_Field"> 电 磁场 传感器 : </string> 
< string name = "Orientation"> 方 向 传感器 : </string> 


10 < string name = "Temperature"> 温 度 传感器 : </string> 
1l < string name = "Light"> 环 境 光 线 传 感 器 : «/string» 

12 < string name = "Pressure"> 压 力 传感器 : </string> 

13 < string name = "Rotation_ Vector"> 旋 转向 量 : </string> 


14 < string name = "Barcode"> 条 码 传感器 : </string> 
15 </resources > 


(4) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 。 在 这 里 使 用 RelativeLayout 
布局 ,代码 如 下 所 示 。 


1 <?xml version= "1.0" encoding = "utf - 8"?> 

2 «LinearLayout 

3 xnlns:android = "http: //schemas. android. com/apk/res/android" 
4  android:orientation = "vertical" 

5 android:layout width- "fill parent" 

6 android:layout height = "fill parent"» 

7 < TextView 

8 android: id = "(à + id/text accelerometer" 

9 android:layout width- "fill parent" 


10 android:layout height = "wrap content" 

11 android: text = "@string/Accelerometer" /> 
12 <TextView 

13 android: id = "(à + id/text linear acceleration" 
14 android:layout width- "fill parent" 

15 android:layout height = "wrap content" 

16 android:text = "(à string/LinearAcceleration" /> 
17 <TextView 

18 android: id = "(à + id/text gravity" 

19 android:layout width- "fill parent" 

20 android:layout height = "wrap content" 

21 android: text = "(Qstring/Gravity" /> 

22  «TextView 

23 android:id- "@ + id/text light" 

24 android:layout width- "fill parent" 

25 android:layout height = "wrap content" 

26 android: text = "(Qstring/Magnetic Field" /> 
27  «TextView 

28 android:id- "(à + id/text temperature" 

29 android:layout width- "fill parent" 

30 android:layout height = "wrap content" 

31 android: text = "(3string/Temperature" /> 


32  «TextView 
33 android:id- "(à + id/text orientation" 


34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:text = "(Ostring/Orientation" /> 
< TextView 
android:id- "@ + id/text magnetic field" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = "(Üstring/Magnetic Field" /> 
< TextView 
android: id = "(à + id/text pressure" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = "(string/Pressure" /> 
< TextView 
android:id- "(à + id/text rotation vector" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:text = "(Qstring/Rotation Vector" /> 
< TextView 
android: id= "(à + id/text barcode" 
android:layout width- "fill parent" 
android:layout height - "wrap content" 
android: text = "(3 string/Barcode" /> 


57 «/LinearLayout > 


(5) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. Sensor 包 下 的 SensorDemoActivity. java 文 


件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


€ 0-00U058&U0NMn-^ 


zu 
^o 


TQ D D [Q DO DM NNE D B p op iS n n 
3260 à GO $2 290'0.-2020^»20U0t 


package cn. com. sgnsc. Sensor; 


import org. openintents. sensorsimulator. hardware. Sensor; 

import org. openintents. sensorsimulator. hardware. SensorEvent; 

import org. openintents. sensorsimulator. hardware. SensorEventListener; 
import org. openintents. sensorsimulator. hardware. SensorManagerSimulator; 


import android. app. Activity; 

import android. hardware. SensorManager; 
import android. os.Bundle; 

import android. widget. TextView; 


public class SensorDemoActivity extends Activity { 
private SensorManagerSimulator mSensorManager; 


private TextView mTextViewAccelerometer; 
private TextView mTextViewGravity; 

private TextView mTextViewLinearAcceleration; 
private TextView mTextViewLight; 

private TextView mTextViewTemperature; 
private TextView mTextViewOrientation; 
private TextView mTextViewMagneticField; 
private TextView mTextViewPressure; 

private TextView mTextViewRotationVector; 
private TextView mTextViewBarcode; 
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28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
7i 
72 
73 
74 
75 
76 
EU) 
78 
79 
80 
81 
82 


private SensorEventListener mEventListenerAccelerometer; 
private SensorEventListener mEventListenerGravity; 

private SensorEventListener mEventListenerLinearAcceleration; 
private SensorEventListener mEventListenerLight; 

private SensorEventListener mEventListenerTemperature; 
private SensorEventListener mEventListenerOrientation; 
private SensorEventListener mEventListenerMagneticField; 
private SensorEventListener mEventListenerPressure; 

private SensorEventListener mEventListenerRotationVector; 
private SensorEventListener mEventListenerBarcode; 


(QOverride 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. main); 


mTextViewAccelerometer - (TextView) findViewById(R. id. text accelerometer); 
mTextViewGravity = (TextView) findViewById(R. id.text gravity); 
mTextViewLinearAcceleration = (TextView) findViewById(R. id.text linear acceleration); 
mTextViewLight = (TextView) findViewById(R. id.text light); 

mTextViewTemperature = (TextView) findViewById(R. id. text temperature); 
mTextViewOrientation = (TextView) findViewById(R. id. text orientation); 
mTextViewMagneticField - (TextView) findViewById(R. id.text magnetic field); 
mTextViewPressure = (TextView) findViewById(R. id. text pressure); 
mTextViewRotationVector = (TextView) findViewById(R. id.text rotation vector); 
mTextViewBarcode = (TextView) findViewById(R. id.text barcode); 


mSensorManager = SensorManagerSimulator.getSystemService(this, SENSOR SERVICE); 
nSensorManager. connectSimulator(); 


initListeners(); // 初 始 化 监听 器 


private void initListeners() ( 
// 创 建 加 速度 传感器 监听 器 
mEventListenerAccelerometer = new SensorEventListener() { 
@Override 
public void onSensorChanged(SensorEvent event) { 
float[] values = event. values; 
mTextViewAccelerometer. setText(getResources( ). getString 
(R. string. Accelerometer) + values[0] * "," + values[1] * "," + values[2]); 
} 
@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
I 
}; 
// 创 建 线 性 加 速 器 监听 器 
mEventListenerLinearAcceleration = new SensorEventListener() { 
(GOverride 
public void onSensorChanged(SensorEvent event) ( 
float[] values = event. values; 
nTextViewLinearAcceleration. setText(getResources().getString 
(R. string. LinearAcceleration) + values[0] * "," + values[1] * "," + values[2]); 
) 
(GOverride 
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public void onAccuracyChanged(Sensor sensor, int accuracy) { 
) 
H 
// 创 建 重力 传感器 监听 器 
mEventListenerGravity = new SensorEventListener() { 
(2 Override 
public void onSensorChanged(SensorEvent event) ( 
float[] values = event. values; 
mTextViewGravity. setText(getResources().getString 
(R. string. Gravity) + values[0] + ", "+ values[1] + ", " + values[2]); 
} 
@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
i 
}; 
// 创 建 电 磁场 传感器 监听 器 
mEventListenerMagneticField = new SensorEventListener() { 
@Override 
public void onSensorChanged( SensorEvent event) { 
float[ ] values = event.values; 
mTextViewMagneticField. setText(getResources().getString 
(R. string.Magnetic Field) + values[0] * "," + values[1] + "," + values[2]); 
) 
(QOverride 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
) 
}; 
// 创 建 方向 传感器 监听 器 
mEventListenerOrientation = new SensorEventListener() { 
@Override 
public void onSensorChanged( SensorEvent event) { 
float[ ] values = event.values; 
mTextViewOrientation. setText(getResources().getString 
(R. string. Orientation) + values[0] * "," + values[1] * "," + values[2]) ; 
) 
@Override 
public void onAccuracyChanged( Sensor sensor, int accuracy) { 
} 
}; 
// 创 建 温度 传感器 监听 器 
mEventListenerTemperature = new SensorEventListener() { 
@Override 
public void onSensorChanged(SensorEvent event) { 
float[] values = event. values; 
mTextViewTemperature. setText (getResources().getString 
(R.string.Temperature) * values[0]); 
) 
(QOverride 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
) 
p 
// 创 建 环境 光 传感器 监听 器 
mEventListenerLight = new SensorEventListener() { 
GOverride 
public void onSensorChanged(SensorEvent event) ( 
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float[] values = event.values; 
nTextViewLight.setText (getResources() . getString(R. string. Light) + values[0]) ; 
) 
(QOverride 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
) 
h 
// 创 建 压力 传感器 监听 器 
mEventListenerPressure = new SensorEventListener() { 
@Override 
public void onSensorChanged(SensorEvent event) { 
float[] values = event. values; 
mTextViewPressure. setText (getResources() . getString(R. string. Pressure) + values[0]) ; 
} 
@Override 
public void onAccuracyChanged( Sensor sensor, int accuracy) { 
) 
ks 
// 创 建 旋转 向 量 监听 器 
mEventListenerRotationVector = new SensorEventListener() { 
(QOverride 
public void onSensorChanged(SensorEvent event) ( 
float[] values = event. values; 
nTextViewRotationVector. setText(getResources().getString 
(R.string.Rotation Vector) + values[0] + "," * values[1] * "," + values[2]) ; 
) 
@Override 
public void onAccuracyChanged( Sensor sensor, int accuracy) { 
} 
}; 


// 创 建 条 形 码 传感器 监听 器 
mEventListenerBarcode = new SensorEventListener() { 
(&Override 


public void onSensorChanged(SensorEvent event) { 
nilextViewBarcode. setText (getResources() . getString(R. string. Barcode)* event. barcode); 

) 

(QOverride 

public void onAccuracyChanged(Sensor sensor, int accuracy) { 


) 


(QOverride 
protected void onResume() ( 
super. onResune( ) ; 
mSensorManager. registerListener(mEventListenerAccelerometer, 
mSensorManager. getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
SensorManager.SENSOR DELAY FASTEST); // 取 加 速度 传感器 信息 
mSensorManager. registerListener(mEventListenerLinearAcceleration, 
mSensorManager.getDefaultSensor(Sensor.TYPE LINEAR ACCELERATION), 
SensorManager.SENSOR DELAY FASTEST); // 取 线性 加 速 器 信息 
mSensorManager. registerListener(mEventListenerGravity, 
mSensorManager. getDefaultSensor(Sensor.TYPE GRAVITY), 
SensorManager. SENSOR DELAY FASTEST); // 取 重力 传感器 信息 
mSensorManager. registerListener(mEventListenerMagneticField, 
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193 mSensorManager. getDefaultSensor (Sensor. TYPE MAGNETIC FIELD), 

194 SensorManager.SENSOR DELAY FASTEST); // 取 电磁 场 传感器 信息 
195 mSensorManager. registerListener(mEventListenerOrientation, 

196 mSensorManager. getDefaultSensor(Sensor.TYPE ORIENTATION), 

197 SensorManager. SENSOR DELAY FASTEST); // 取 方向 传感器 信息 
198 mSensorManager. registerListener(mEventListenerTemperature, 

199 mSensorManager. getDefaultSensor(Sensor.TYPE TEMPERATURE), 

200 SensorManager.SENSOR DELAY FASTEST); // 取 温度 传感器 信息 
201 mSensorManager. registerListener(mEventListenerLight, 

202 mSensorManager. getDefaultSensor(Sensor.TYPE LIGHT), 

203 SensorManager.SENSOR DELAY FASTEST); // 取 环境 光线 传感器 信息 
204 mSensorManager. registerListener(mEventListenerPressure, 

205 mSensorManager. getDefaultSensor(Sensor. TYPE PRESSURE), 

206 SensorManager. SENSOR DELAY FASTEST); // 取 压力 传感器 信息 
207 mSensorManager. registerListener(mEventListenerBarcode, 

208 mSensorManager.getDefaultSensor(Sensor. TYPE BARCODE READER), 

209 SensorManager.SENSOR DELAY FASTEST); // 取 条 形 码 传感器 信息 
210 mSensorManager. registerListener(mEventListenerRotationVector, 

211 mSensorManager. getDefaultSensor (Sensor. TYPE ROTATION VECTOR), 

212 SensorManager. SENSOR_DELAY FASTEST); // 取 旋转 向 量 信息 

213 ) 

214 


215 @Override 
216 protected void onStop() { 


217 mSensorManager. unregisterListener(mEventListenerAccelerometer); 
218 mSensorManager. unregisterListener(mEventListenerLinearAcceleration); 
219 mSensorManager. unregisterListener(mEventListenerGravity); 

220 mSensorManager. unregisterListener(mEventListenerMagneticField); 
221 mSensorManager. unregisterListener(mEventListenerOrientation); 
222 mSensorManager. unregisterListener(mEventListenerTemperature); 
223 mSensorManager. unregisterListener(mEventListenerLight); 

224 mSensorManager. unregisterListener(mEventListenerPressure); 

225 mSensorManager. unregisterListener(mEventListenerRotationVector); 
226 mSensorManager. unregisterListener(mEventListenerBarcode); 

227 super. onStop() ; 

228 } 

229 } 


(D $ 55.56 行 创建 一 个 SensorManagerSimulator 对 象 , 并 连接 到 SensorSimulator 模拟 
器 上 。 

© 58 61—178 行 ,为 10 个 传感器 创建 传感器 监听 器 ,在 监听 器 中 重 写 onSensorChanged() 和 
onAccuracyChanged() 方 法 。 其 中 ,float[] values = event. values 是 从 传感器 中 获得 传 感 数 
据 , 有 些 传感器 只 有 一 个 数据 ,有 些 传感器 有 三 个 数据 ,所 以 需要 使 用 一 个 数组 来 表示 。 

© 5$ 181—213 fT. f£ onResume() 方 法 中 为 这 10 个 传感器 进行 注册 。 

@ 第 216 一 228 行 ,在 onStop() 方 法 中 注销 这 10 个 传感器 。 

(6) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml 文件 .Jf- YE — manifest ^ b 4& P Hn 
入 权限 : 


< uses - permission android:name = " android. permission. INTERNET" /> 


【运行 结果 】 在 书 中 ,SensorSimulator 软件 所 在 文件 夹 路 径 为 “E:\ sensorsimulator- 
2.0-rcl”, 那 么 要 首先 运行 E:\ sensorsimulator-2. 0-rcl\bin 下 的 sensorsimulator-2. 0-rcl. jar 
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xf. 


然后 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 SensorDemo 项 目 。 
H 


在 SensorSimulator 工具 软件 窗口 的 左上 角 ， 


鼠标 模拟 操纵 手机 ,如 图 11-23 所 示 。 于 


是 可 在 Android 模拟 器 中 看 到 相应 的 数据 变化 ,如 图 11-24 所 示 。 


(9) vaw & pitch. © roll & pitch 


Sensor update: 
magnetic field: -7.87, -29.04, -38.96 
orientation: 34.00, -54.00, 0.00 
temperature: 8.00 
barcode reader. 1234567890123 
light: 558.00 
pressure: 0.32 
linear acceleration: 0.00, 0.00, -0.00 
gravity. 0.00, 8 81,430 
rotation vector. -0.53, 0.29, 0.00 


图 11-23 SensorSimulator 模拟 的 当前 数据 


© move 


10.00 ml 


Sensors | Scenario 


Choose Device 


Medium 
Basic Orientation 


accelerometer 
|, magnetic feld 
orientation 


Extended Orientation 


linear acceleration 
[7 


图 11-24 Android 模拟 器 运行 的 结果 


更 多 的 时 候 , 开 发 一 个 传感器 应 用 ,不 仅 需要 有 这 些 数据 ,还 需要 有 相应 的 UI 界面 来 体 
现 传 感 的 效果 。 下 面 通过 一 个 自 定 义 界 面 控件 的 案例 来 说 明 这 方面 的 应 用 。 

【案例 11.8】 全 方位 的 圆 形 水 平 仪 。 只 感应 方向 传感器 。 

【说 明 】 案例 使 用 自 定义 的 控件 来 布局 水 平 仪 用 户 界面 ,这 个 自 定义 控件 的 初始 界面 将 


由 一 个 Java 代码 文件 来 定制 。 


在 代码 文件 中 ,以 注释 的 方式 给 出 了 在 真 机 上 运行 时 的 代码 片断 。 


【开发 步骤 及 解析 】 


CD 创建 项 目 。 在 Eclipse 中 创建 一 个 名 为 SensorLevel 的 Android 项 目 。 其 应 用 程序 名 
为 SensorLevel, 包 名 为 cn. com. sgmsc. level. Activity 组 件 名 为 SensorLevelActivity。 

(2) 添加 JAR 包 。 为 该 项 目 添加 JAR 包 。 

(3) 准备 图 片 资源 。 准 备用 于 水 平 仪 中 的 标尺 条 和 圆 以 及 位 于 其 上 的 水 泡 图片 ,将 它们 
复制 到 res/drawable-mdpi 目录 中 。 

(4) 设计 布局 。 编 写 res/layout 目录 下 的 main. xml 文件 。 在 这 里 使 用 RelativeLayout 


布局 ,代码 如 下 所 示 。 


1 <?xml version- "1.0" encoding = "utf 一 8"?> 
2 «LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
3 android:layout width- "fill parent" 


20065 


android:layout height = "fill parent" 
android:orientation = "vertical" > 


< cn. con. sgnsc. level. MainView 
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8 android:id- "(à + id/mainView" 

9 android:layout width- "fill parent" 
10 android:layout height - "fill parent" 
11 人 ><!-- 自 定义 View--» 

12 


13 «/LinearLayout > 


第 7 一 11 行 ,声明 一 个 自 定 义 的 控件 ,该 控件 定义 在 cn. com. sgmsc. level 4 F ,定义 的 类 
名 为 MainView. java。 

(5) 开发 自 定 义 控件 类 代码 。 在 src/cn. com. sgmsc. level 包 下 新 建 一 个 名 为 MainView. 
java 的 文件 ,并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgnsc. level; 


D] 
2 
3 import android. content. Context; 

4 import android. graphics. Bitmap; 

5 import android. graphics. BitmapFactory; 
6 import android. graphics. Canvas; 

7 import android. graphics. Color; 

8 import android. graphics. Paint; 

9 import android. graphics. RectF; 

10 import android. graphics. Paint. Style; 
11 import android. util. AttributeSet; 

12 import android. view. View; 


13 

14 public class MainView extends View( 

15 

16 Paint paint = new Paint(); MILEA 

17 

18 — //F8 Hr VEUR (9 H 

19 

20 Bitmap CLB Bitmap; // 中 间 的 大 圆 图 
21 Bitmap CLS Bitmap; // 中 间 的 小 气泡 
22 Bitmap HB Bitmap; // 上 面 的 大 和 矩形 图 
23 Bitmap HS Bitmap; // 上 面 的 气泡 

24 Bitmap VB Bitmap; // 左 面 的 大 矩形 图 
25 Bitmap VS Bitmap; // 左 面 的 气泡 

26 Bitmap HVB Bitmap; // 右 下 的 矩形 图 
27 Bitmap HVS_Bitmap; // 右 下 的 气泡 

28 

29 “// 背 景 矩 形 的 位 置 声明 

30 


31  intcircleB X = 70; // 中 间 的 大 圆 图 坐标 
32  intcircleB Y = 70; 


33 int horizontalB X - 60; // 上 面 的 大 和 矩形 图 坐标 
34 int horizontalB Y = 12; 

35  intverticalB X = 12; // 左 面 的 大 矩形 图 坐标 
36  intverticalB Y = 60; 

37  intHVB X = 145; // 右 下 的 矩形 图 坐标 
38  intHVB Y = 145; 

39  intcircleS X; // 中 间 的 小 气泡 xv 坐标 
40  intcircleS Y; 

41 int horizontalS X; // 上 面 的 气泡 xv 坐标 


42 int horizontalS Y; 
43  intverticalS X; // 左 面 图 的 气泡 XY 坐标 


415 
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44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 


int verticalS Y; 

int HVS X; // 右 下 的 气泡 xy 坐标 
int HVS_Y; 

public MainView(Context context, AttributeSet attrs){ 


super(context,attrs); 


initBitmap(); // 初 始 化 图 片 资源 
initLocation(); // 初 始 化 气泡 的 位 置 
private void initBitmap(){ // 初 始 化 图 片 的 方法 


CLB Bitmap = BitmapFactory. decodeResource(getResources(),R. drawable. cll); 
CLS Bitmap = BitmapFactory.decodeResource(getResources( ) , R. drawable. c12); 
HB Bitmap = BitmapFactory.decodeResource(getResources(), R. drawable. h1); 
HS Bitmap = BitmapFactory.decodeResource(getResources(), R. drawable. h2) ; 
VB Bitmap = BitmapFactory.decodeResource(getResources(), R. drawable. v1) ; 
VS Bitmap = BitmapFactory.decodeResource(getResources(), R. drawable. v2) ; 
HVB Bitmap = BitmapFactory.decodeResource(getResources(), R. drawable. hv); 
HVS Bitmap = BitmapFactory.decodeResource(getResources(), R. drawable. hv2) ; 


private void initLocation()( // 初 始 化 气泡 位 置 的 方法 


circleS X = circleB X + CLB Bitmap.getWidth()/2-— CLS Bitmap.getWidth()/2; 
circleS Y = circleB Y + CLB Bitmap.getHeight()/2- CLS Bitmap.getHeight()/2; 
horizontalS X = horizontalB X + HB Bitmap.getWidth()/2- HS Bitmap.getWidth()/2; 
horizontalS Y = horizontalB Y + HB Bitmap.getHeight()/2 - HS Bitmap.getHeight()/2; 
verticalS X = verticalB X + VB Bitmap.getWidth()/2- VS Bitmap.getWidth()/2; 
verticalS Y = verticalB Y + VB Bitmap.getHeight()/2- VS Bitmap.getHeight()/2; 
HVS X = HVB X + HVB Bitmap.getWidth()/2 - HVS Bitmap.getWidth()/2; 

HVS Y = HVB Y + HVB Bitmap.getHeight()/2- HVS Bitmap.getHeight()/2; 


(QOverride 

protected void onDraw(Canvas canvas)( // 重 写 的 绘制 方法 
super. onDraw(canvas) ; 
canvas. drawColor(Color. WHITE); // 设 置 背 景色 为 白色 
paint. setColor(Color. BLUE) ; // 设 置 画笔 颜色 
paint. setStyle(Style. STROKE) ; // 设 置 画笔 为 不 填充 
canvas. drawRect(5, 5, 315, 315, paint); // 绘 制 外 边框 矩形 
// 画 背景 矩形 

canvas.drawBitmap(CLB Bitmap, circleB X,circleB Y, paint); // 中 


canvas.drawBitmap(HB Bitmap, horizontalB X,horizontalB Y, paint); // 上 
canvas.drawBitmap(VB Bitmap, verticalB X,verticalB Y, paint); // 左 


canvas.drawBitmap(HVB Bitmap, HVB X,HVB Y, paint); T 
// 开 始 绘制 气泡 
canvas.drawBitmap(CLS Bitmap, circleS X,circleS Y, paint); // 中 


canvas.drawBitmap(HS Bitmap, horizontalS X,horizontalS Y, paint); // 上 
canvas.drawBitmap(VS Bitmap, verticalS X,verticalS Y, paint); // 左 
canvas.drawBitmap(HVS Bitmap, HVS X, HVS Y, paint); /TFT 
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99  paint.setColor(Color.GRAY); // 设 置 画笔 颜色 用 来 绘制 刻度 
100 

101  // 绘 制 上 面 方 框 中 的 刻度 

102 canvas. drawLine (horizontalB X- HB Bitmap.getWidth()/2- 7, 

103 horizontalB Y, horizontalB X+ HB Bitmap. getWidth()/2 - 7, 

104 horizontalB Y ^ HB Bitmap. getHeight() — 2, paint); 

105 canvas. drawLine (horizontalB X+ HB Bitmap.getWidth()/2 * 7, 

106 horizontalB Y, horizontalB X+ HB Bitmap. getWidth()/2 * 7, 

107 horizontalB Y + HB Bitmap.getHeight() - 2, paint); 

108 


109 ”// 绘 制 左面 方 框 中 的 刻度 
110  canvas.drawLine(verticalB X,verticalB Y+ VB Bitmap. getHeight()/2-7, 


111 verticalB X+ VB Bitmap.getWidth() - 2, 

112 verticalB Y+ VB Bitmap.getHeight()/2 - 7, paint); 

113  canvas.drawLine(verticalB X,verticalB Y + VB Bitmap. getHeight()/2 * 7, 
114 verticalB X+ VB Bitmap.getWidth() - 2, 

115 verticalB Y * VB Bitmap.getHeight()/2 * 7, paint); 

116 


117.— //f& EF T Jr E nb d 23] E 
118 canvas. drawLine(HVB_X + HVB Bitmap.getWidth()/2 - 10, 


119 HVB Y + HVB Bitmap. getHeight()/2- 20, 

120 HVB X + HVB Bitmap. getWidth()/2 + 20, 

121 HVB Y * HVB Bitmap.getHeight()/2 * 10, paint); 

122 canvas. drawLine(HVB_X + HVB Bitmap.getWidth()/2 - 20, 

123 HVB_Y + HVB Bitmap.getHeight()/2— 10,HVB X + HVB Bitmap.getWidth()/2 + 10, 
124 HVB Y * HVB Bitmap.getHeight()/2 * 20, paint); 

125 


126 “// 中 间 圆 圈 中 的 刻度 (小 圆 ) 
127  RectF oval = new RectF(circleB X + CLB Bitmap.getWidth()/2- 10, 


128 circleB Y + CLB Bitmap.getHeight()/2 - 10, 

129 circleB X+ CLB Bitmap.getWidth()/2 + 10, 

130 circleB Y+ CLB Bitmap.getHeight()/2 * 10); 

131  canvas.drawOval(oval, paint); // 绘 制 基 准 线 ( 圆 ) 
132 ] 

133 } 


(D 第 48 一 54 行 ,定义 构造 方法 。 在 其 中 使 用 两 个 自 定义 的 方法 ,initBitmap() 用 于 为 各 
图 片 控件 指定 图 片 资源 ,initLocation() 用 于 计算 气泡 的 初始 位 置 坐标 。 

© 第 81~132 行 , 重 写 onDraw() 方 法 。 其 中 ,第 83 一 86 行 定义 画布 背景 区 域 , 水 平 仪 图 
片 就 在 该 区 域内 ; 第 89 一 92 行 绘制 水 平 仪 背景 图 片 ; 第 95 一 99 行 绘制 气泡 图 片 ; 第 102 一 
131 行 绘制 每 一 部 分 的 居中 刻度 线 。 

(6) 开发 逻辑 代码 。 打 开 src/cn. com. sgmsc. level 包 下 的 SensorLevelActivity. java X 
件 , 并 编辑 之 。 其 代码 如 下 所 示 。 


package cn. com. sgmsc. level; 


import org. openintents. sensorsimulator. hardware. Sensor; 

import org. openintents. sensorsimulator. hardware. SensorEvent; 

import org. openintents. sensorsimulator. hardware. SensorEventListener; 
import org. openintents. sensorsimulator. hardware. SensorManagerSimulator; 


import android. app. Activity; 
import android. hardware. SensorManager; 
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import android. os. Bundle; 


public class SensorLevelActivity extends Activity { // 继 承 Activity 
MainView mv; //3: View 
intk = 45; 1 ER SOR 
//SensorManager nySensorManager; // 真 机 时 


SensorManagerSimulator mySensorManager; 
SensorEventListener myEventSensorListener; 


(QOverride 

public void onCreate(Bundle savedInstanceState)( 
super. onCreate(savedInstanceState); 
setContentView(R. layout. main); 


mv = (MainView) findViewById(R. id. mainView); 


// 测 试 时 , SensorManager 对 象 引 用 


// 设 置 当 前 的 用 户 界面 
// 获 取 主 界面 


mySensorManager = SensorManagerSimulator. getSystemService(this, SENSOR SERVICE); 


mySensorManager. connectSimulator(); 


// 测 试 时 
// 测 试 时 


//mySensorManager = (SensorManager)getSystemService(SENSOR SERVICE); // 真 机 


myEventSensorListener = new SensorEventListener() ( // 传 感 器 监听 器 类 


@Override 


public void onAccuracyChanged( Sensor sensor, int accuracy) {} 


@Override 


// 重 写 onAccuracyChanged() 方 法 


public void onSensorChanged(SensorEvent event) {// 重 写 onSensorChanged( ) 方 法 


float[] values = event. values; 


double pitch = values[SensorManager.DATA Y]; 

double roll = values[SensorManager.DATA Z]; 

int x=0; int y= 0; // 临 时 变量 , 算 中 间 水 泡 坐 标 时 用 
int tempX = 0; int tempY= 0; // 下 面 气泡 的 临时 变量 


// 开 始 调整 x 的 值 
if(Math.abs(roll)« - k)( 


mv.horizontalS X = mv.horizontalB X + (int)(((mv.HB Bitmap. getWidth() 
— mv. HS Bitmap. getWidth())/2.0) — (( (mv. HB Bitmap. getWidth( ) 
-mv.HS Bitmap.getWidth())/2.0) *roll)/k); // 上 面 的 
x = mv.circleB X + (int)(((mv.CLB Bitmap.getWidth() 
—mv.CLS Bitmap.getWidth())/2.0) — (((mv.CLB Bitmap.getWidth() 
-mv.CLS Bitmap.getWidth())/2.0) * roll)/k); // 中 间 的 
Jelse if(roll»k)( 
mv.horizontalS X= mv.horizontalB X; 
x 7 mv.circleB X; 
Jeise( 
mv.horizontalS X= mv.horizontalB X* mv.HB Bitmap.getWidth() 
— mv.HS Bitmap.getWidth(); 
x = mv.circleB X+ mv.CLB Bitmap.getWidth() — mv.CLS Bitmap.getWidth(); 
} 


// 开 始 调整 y 的 值 
if(Math.abs(pitch)«- k)( 
mv.verticalS Y = mv.verticalB Y + (int)(((mv.VB Bitmap.getHeight() 
—nv.VS Bitmap.getHeight())/2.0) + (((mv. VB Bitmap. getHeight() 
—mv.VS Bitmap.getHeight())/2.0) * pitch)/k); // 左 面 的 
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y = mv. circleB Y+ (int) (((mv. CLB_Bitmap. getHeight ( ) — mv. CLS_Bitmap. 
getHeight())/2. 0) 
+ (((mv.CLB Bitmap. getHeight() - mv. CLS_Bitmap. getHeight())/2.0) * 
pitch)/k); // 中 间 的 
Jelse if(pitch» k)( 
mv.verticalS Y = mv.verticalB Y + mv.VB Bitmap.getHeight() - mv.VS_ 
Bitmap. getHeight(); 
y= mv.circleB Y + mv. CLB Bitmap.getHeight() - mv.CLS Bitmap.getHeight(); 
Jeise( 
mv.verticalS Y = mv.verticalB Y; 
y = nv.circleB Y; 


// 下 面 的 

tempX = - (int)(((mv.HVB Bitmap.getWidth()/2— 28) * roll 
+ (nv. HVB Bitmap. getWidth()/2 — 28) * pitch)/k); 

tempY = - (int)(( - (mv.HVB Bitmap.getWidth()/2 - 28) * roll 
— (nv. HVB Bitmap. getWidth()/2 - 28) * pitch)/k); 


// 限 制 下 面 的 气泡 范围 
if(tempY > mv. HVB_Bitmap. getHeight()/2— 28)( 
tempY = mv.HVB Bitmap.getHeight()/2 - 28; 
) 
if(tempY« - mv.HVB Bitmap.getHeight()/2 + 28)( 
tempY = - mv.HVB Bitmap.getHeight()/2 * 28; 
) 
if(tempX > mv.HVB Bitmap.getWidth()/2 - 28) { 
tempX = mv.HVB Bitmap.getWidth()/2- 28; 
) 
if(tempX« - mv.HVB Bitmap.getWidth()/2 + 28)( 
tempX = - mv.HVB Bitmap.getWidth()/2 + 28; 
} 
mv.HVS X = tempX + mv.HVB X + mv. HVB_Bitmap. getWidth( )/2 
- mv. HVS_Bitmap. getWidth()/2; 
mv.HVS Y = tempY + mv.HVB Y + mv. HVB Bitmap.getHeight()/2 
- mv.HVS Bitmap.getWidth()/2; 


// 中 间 的 水 泡 在 圆 内 才 改 变 坐 标 
if(isContain(x, y))( 
mv.circleS X = x; 
mv.circleS Y - y; 


} 


mv. postInvalidate(); // 重 绘 MainView 


public boolean isContain(int x, int Y){ // 判 断 点 是 否 在 圆 内 
int tempx = (int)(x + mv.CLS Bitmap.getWidth()/2.0); 
int tempy = (int)(y + nv.CLS Bitmap.getWidth()/2.0); 
int ox = (int)(mv.circleB X+ mv.CLB Bitmap.getWidth()/2.0); 
int oy = (int)(mv.circleB X+ mv.CLB Bitmap.getWidth()/2.0); 
if(Math.sgrt((tempx- ox) * (tempx- ox) + (tempy - oy) * (tempy - oy)) 


419 


V 


420 


Android 应 用 开发 教程 


112 >(mv. CLB Bitmap. getWidth()/2.0 — mv. CLS Bitmap. getWidth()/2.0))( 
// 不 在 圆 内 

113 return false; 

114 Jelse( // 在 圆 内 时 

115 return true; 

116 } 

117 } 

118 b 

119 } 

120 

121 @Override 

122 protected void onResume() { // 重 写 的 onResume( ) 方 法 

123 mySensorManager. registerListener( // 注 册 监 听 

124 myEventSensorListener, // 监 听 器 SensorListener 对 象 

125 mySensorManager. getDefaultSensor(Sensor. TYPE_ORIENTATION), // 只 检查 方向 的 

// 变 化 

126 SensorManager.SENSOR DELAY UI // 频 度 

127 ) 

128 super. onResune( ) ; 

129 } 

130 

131 @Override 

132 protected void onPause() { // 重 写 onPause( ) 方 法 

133 mySensorManager. unregisterListener(myEventSensorListener); // 取 消 注册 监听 器 

134 super. onPause( ) ; 

135 } 

136 

137 } 


(D 第 35 一 104 行 重 写 了 onSensorChanged() 方 法 ,用 于 监听 传感器 方向 的 采样 值 变化 ,并 
根据 其 新 的 采样 值 重新 绘制 各 部 分 气泡 的 位 置 ,这 些 气泡 都 被 限定 在 其 各 自 的 背景 矩形 或 圆 
的 范围 内 。 

© 第 103 行 通过 调用 postInvalidate() 方 法 来 重 绘 MainView。 

@ 第 106—117 行 是 判断 点 是 否 在 圆 内 的 方法 。 

@ 第 122 一 129 FEE onResume() 方 法 ,在 该 方法 中 注册 方向 监听 器 。 

© 第 132—135 行 重 写 onPause() 方 法 ,在 该 方法 中 注销 方向 监听 器 。 

(7) 添加 权限 。 打 开 根 目录 下 的 AndroidManifest. xml 文件 ,并 在 二 manifest 二 标签 中 加 
入 权限 


< uses - permission android:name = " android. permission. INTERNET" /> 


【运行 结果 】 首先 运行 E:\ sensorsimulator-2. 0-rcl\bin 下 的 sensorsimulator-2. 0-rcl. 
jar 文件 。 

然后 在 Eclipse 中 启动 Android 模拟 器 ,然后 运行 SensorLevel 项 目 。 初 始 运 行 效果 如 
图 11-25 所 示 。 

在 SensorSimulator 工具 软件 窗口 的 左上 角 , 用 鼠标 模拟 操纵 手机 ,如 图 11-26 所 示 。 于 
是 可 在 Android 模拟 器 中 看 到 相应 的 数据 变化 ,如 图 11-27 所 示 。 


第 11 章 手机 基本 功能 开发 


(Qm 


O rew&ptn @ rlsptn © move 
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Sensortevel. 


Sensortevel. 


Sensor update 1100 mi 


accelerometer.-5.13, 153, 821 
magnetic feld: 25.10, 16.58, -38.96 
orientation 13.00, -2.00, 32 00 
light 400.00 

gradtr -513.153.821 


图 11-27 Android 模拟 器 运行 
的 结果 


11-26 SensorSimulator 模拟 的 
当前 数据 


图 11-25 SensorLevel 项 目 初始 
运行 效果 


小 结 
hä 


本 章 主要 介绍 了 常用 的 有 关 手 机 特性 的 Android 应 用 的 开发 。 对 于 短信 、 电 话 控制 ,手机 
系统 的 设置 变化 ,手机 电信 网 络 信息 ,手机 电池 电量 的 监测 ,以 及 手机 传感器 的 应 用 给 出 了 案 
例 进行 详细 的 介绍 。 在 开发 手机 特性 的 应 用 中 ,有 较 多 的 应 用 需要 添加 权限 声明 ,请 读者 要 留 
意 。 手 机 传感器 涉及 手机 硬件 方面 的 需求 ,在 模拟 器 上 开发 这 方面 的 应 用 ,必须 要 在 
SensorSimulator 工具 的 协助 下 进行 。 

到 本 章 为 止 ,分 门 别 类 地 介绍 了 关于 Android 应 用 开发 的 基础 知识 、 开 发 技术 和 编程 技 
巧 , 相 信 读 者 已 具备 了 Android 应 用 项 目的 开发 能 力 , 第 12 章 中 将 进行 一 个 综合 实例 开发 全 
过 程 的 学 习 , 让 读者 体会 一 下 完整 的 应 用 项 目的 开发 始终 。 


(&3 


1. 在 “掌上 微 博 " 中 增加 一 个 收发 邮件 的 功能 。 
2. 在 “掌上 微 博 " 中 增加 方向 感应 功能 。 
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手机 微 博 是 智能 手机 继 即 时 通信 之 外 的 又 一 个 吸引 人 的 应 用 。 手 机 随时 随地 的 拍摄 功能 
和 随时 随地 的 联网 功能 ,使 用 手机 的 微 博 较 之 计算 机 更 有 优势 。 运 行 在 手机 上 的 微 博 是 客户 
端的 应 用 程序 ,中 国 几 个 著名 的 互联 网 综合 服务 提供 商 如 腾讯 新浪、 网易 等 公司 都 有 向 用 户 
提供 这 一 应 用 的 下 载 。 当 然 ,也 可 以 根据 自己 的 需要 , 量 身 订 制 自己 的 手机 微 博 应 用 。 本 章 将 
介绍 手机 微 博 客户 端 应 用 程序 开发 实例 。 


(2.1. 手机 微 博 的 功能 
so 


随 着 移动 互联 网 技术 的 发 展 , 风 靡 全 球 的 博客 也 从 计算 机 向 移动 便携 设备 发 展 , 并 且 在 风 
格 上 趋向 于 微型 化 和 简捷 化 。 通 常 ,设计 一 个 博客 系统 包括 Web 服务 器 、Web 端 系统 和 手机 
客户 端 系统 。 本 章 主 要 介绍 在 Android 平台 下 开发 的 手机 客户 端的 系统 设计 。 


12.1.1 手机 微 博 功能 介绍 


手机 微 博 客户 端 主要 为 用 户 提供 一 个 信息 发 布 和 共享 的 平台 ,其 功能 与 Web 浏览 器 端 系 
统 功 能 差不多 ,其 总 体 功能 框架 如 图 12-1 所 示 。 


Android 客 户 端 
注册 登录 
ED Cex) 


[ I I ] 
(首页 】 (发 微 博 】 (个 人 信息 ) (ua) ( 查找 ) 


图 12-1 Android 客户 端 功能 框架 图 


图 12-1 列 出 了 Android 客户 端 系统 的 功能 模块 ,下 面 对 这 些 模块 分 别 进行 简单 介绍 。 

(1) 注册 ,为 初次 使 用 本 系统 的 用 户 提供 注册 服务 。 该 模块 连接 到 服务 器 上 ,为 用 户 在 服 
务 器 上 申请 一 个 微 博 用 户 号 ,上 传 头像 ,记录 登录 微 博 的 密码 .注册 时 间 等 信息 。 

(2) 登录 ,为 已 注册 的 用 户 使 用 本 系统 提供 登录 窗口 。 这 是 进入 手机 客户 端的 第 一 个 界 
面 ,在 登录 窗口 中 提供 “登录 ”“ 注 册 ” 两 个 按钮 .分 别 可 进入 两 种 不 同 的 状态 。 

O 个 人 中 心 , 从 登录 (或 注册 ) 窗 口 进入 后 就 是 个 人 中 心 。 个 人 中 心包 含 微 博客 户 端 系 
统 可 以 使 用 的 功能 和 服务 , 它 以 选项 卡 的 形式 呈现 在 用 户 面前 ,默认 情况 下 显示 微 博 的 首页 。 
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(4) 首页 ,以 列表 的 形式 将 本 用 户 发 送 的 微 博 以 及 本 用 户 所 关注 的 微 博 全 部 显示 出 来 ,并 可 
以 对 列表 进行 分 页 统计 ,可 以 查看 各 条 微 博 的 详细 信息 以 及 对 各 条 微 博 进行 转发 ,评论 和 收藏 。 

(5) 发 微 博 , 用 户 在 此 窗口 中 可 以 编辑 和 发 送 微 博 内 容 , 微 博文 字 字 符 数 在 150 字 以 内 。 
系统 可 以 实时 统计 可 输入 的 字符 个 数 。 

(6) 个 人 信息 ,用 户 在 此 窗口 查看 注册 时 录入 的 主要 信息 ,以 及 本 用 户 已 发 表 的 博客 数目 ， 
关注 其 他 用 户 数 及 其 关注 谁 ,自己 被 其 他 用 户 关 注 数 ( 即 粉 丝 数 ) 及 其 被 谁 关注 等 详细 信息 。 

(7) 收藏 ,管理 用 户 收藏 的 博客 。 在 收藏 窗口 中 ,以 列表 的 方式 列 出 被 收藏 的 所 有 博客 ， 
并 可 以 删除 收藏 的 博客 。 

(8) 查找 ,可 以 模糊 搜索 其 他 用 户 的 昵称 ,并 且 可 以 将 搜索 到 的 用 户 添加 为 自己 的 好 友 ， 
即 关 注 该 用 户 。 


12.1.2 开发 环境 和 目标 平台 
1. 开发 环境 


手机 微 博 客户 端 是 在 Android 平台 下 开发 的 ,并 且 需 要 访问 服务 器 和 数据 库 。 因 此 开发 
该 手机 客户 端 程序 需要 用 到 如 下 的 软件 。 

CD Java 开发 工具 ,JDK 1.7 及 其 以 上 版 本 。 本 实例 使 用 的 JDK 版 本 及 安装 配置 见 1. 3 
节 描 述 。 

(2) Web 应 用 服务 器 ,Tomcat 7.0 及 其 以 上 版 本 。 该 软件 可 以 从 网 络 上 免费 下 载 。 本 实 
例 使 用 的 Tomcat 版 本 及 安装 配置 见 10. 2. 1 节 描 述 。 

(3) 数据 库 , 服 务 器 端 数据 库 MySQL Server 5. 1 及 其 以 上 版 本 和 客户 端 数 据 库 MySQL 
WorkBench 5.2 及 其 以 上 版 本 。 这 些 软 件 可 以 从 官方 网 站 上 免费 下 载 。 本 书 使 用 的 MySQL 服 
务 器 端 安装 程序 是 mysql-essential-5. 1. 51-win32. exe. 客户 端 安装 程序 是 mysql-workbench-gpl- 
5.2. 28-win32. exe, 其 安装 及 配置 将 在 12. 2. 2 节 中 详细 介绍 。 

(4) 集成 开发 环境 ,Eclipse IDE for Java EE Developers。 该 软件 可 以 从 官方 网 站 上 免费 
下 载 。 本 书 使 用 的 JDK 版 本 及 安装 配置 见 1. 3 节 中 描述 。 

(5) Android SDK 及 其 Eclipse 开发 插件 ADT。 它 们 都 可 以 从 网 络 上 免费 下 载 。 其 使 用 
的 版 本 及 安装 配置 见 1. 3 节 中 描述 。 


2. 目标 平台 


手机 微 博客 户 端 程序 开发 完成 后 ,经 打包 签名 ,可 运行 在 Android 2. 1 及 其 以 上 版 本 的 平 
e 
上 T. 


e 2 数据 库 服务 器 及 Web 端 应 用 程序 相关 说 明 


本 系统 在 服务 器 端的 MySQL 数据 库 中 创建 数据 库 表 , Web 浏览 器 客户 端 和 手机 客户 端 
将 博客 的 相关 信息 和 用 户 信息 都 保存 在 这 个 数据 库 中。 在 开发 系统 前 ,首先 要 对 整个 系统 的 
数据 库 进 行 设计 。 

12.2.1 数据 库 表 说 明 

本 系统 数据 库 名 为 microblog ,总共 包括 8 个 表 , 分 别 为 管理 员 信息 表 , 用 户 信息 表 , 微 博 
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信息 表 , 收 藏 信息 表 , 发 表 评论 信息 表 , 回 复 信 息 表 , 转 发 信息 表 和 关注 信息 表 。 下 面 对 其 数据 
表 表 结构 逐一 进行 介绍 ,如 表 12-1 一 表 12-8 所 示 。 
R121 管理 员 信息 表 tb admin 
字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 明 
管理 员 ID 号 ,主键 , 自 增 量 。 用 来 唯 


" j S EO | 一 标识 一 组 管理 员 信息 的 编号 
adm_name varchar 50 否 管理 员 名 称 

adm_password varchar 50 否 管理 员 密 码 
adm_lastLoginTime | date 最 近 一 次 登录 的 日 期 
adm_lastLoginIp varchar 50 最 近 一 次 登录 的 IP 地 址 


表 12-2 ”用户 信息 表 tb user 
字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 明 
用 户 ID 号 ,主键 , 自 增 量 。 用 来 唯一 


TR " M p sm 95 | 标识 一 组 用 户 信息 的 编号 
u_name varchar 50 否 用 户 名 

u_password varchar 50 否 密码 

u picture varchar 50 头像 

u trueName varchar 20 真实 姓名 

u age int 11 年 龄 

u_lastLoginTime date 最 近 一 次 的 登录 时 间 

u registerTime date 注册 时 间 

u_isActivity bit 1 用 户 是 否 有 效 
u_lastLoginIp varchar 50 最 近 一 次 的 登录 IP 


表 12-3 MAER th_microblog 


字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 上 明 
微 博 ID 号 ,主键 , 自 增 量 。 用 来 唯一 


mb_id int 11 是 否 标识 一 组 微 博 信息 的 编号 
mb_content longtext 否 微 博 内 容 

mb_time date 写 微 博时 间 

mb_ip varchar 50 写 微 博 所 用 IP 

u id int 1 用 户 ID 号 ,外 键 。 来 自 tb user 表 中 


R 12-4 收藏 信息 表 tb collection 


字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 明 
收藏 ID 号 ,主键 , 自 增 量 。 用 来 唯一 


es eR ma 95 | 标识 一 组 收藏 信息 的 编号 

cc_time date 收藏 的 时 间 

本 st ü 微 博 ID 号 ,外 键 。 来 自 tb. microblog 
表 中 


u id int 11 用 户 ID 号 ,外 键 。 来 自 tb_user 表 中 


表 12-5 发 表 评论 信息 表 tb_comment 
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字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 RB 
I . 评论 ID 号 ,主键 , 自 增 量 。 用 来 唯一 标 
cm id int 11 是 [i 识 一 组 评论 信息 的 编号 
cm_content longtext 8 评论 内 容 
cm_time date 评论 时 间 
cm ip varchar 50 评论 所 用 IP 
b id m 11 微 博 ID 号 ,外 键 。 来自 tb_microblog 
mbi in deb 
u id int 1 HP ID S ,.5 8. 3B tb user 表 中 
312-6 回复 信息 表 tb reply 
字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 明 
. Jj 回复 ID 号 ,主键 , 自 增 量 。 用 来 唯一 
2 "hu e TO | 标识 一 组 回复 信息 的 编号 
rp_content longtext 否 回复 内 容 
rp_time date 回复 时 间 
rp ip varchar 50 回复 所 用 的 TP 
id T u 评论 ID 号 ,外 键 。 来 自 tb_comment 
em i ini deb 
T " 发 送 回复 用 户 ID 号 ,外 键 。 来 自 tb_ 
u id from int 11 
user 表 中 
接收 回复 用 户 ID S. BE, KÁ tb 
u id to int 11 
user 表 中 
表 12-7 转发 信息 表 tb transmit 
字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 RB 
, r 转发 ID 号 ,主键 , 自 增 量 。 用 来 唯一 
tm_id int 11 是 否 标识 一 组 转发 信息 的 编号 
tm_content longtext 否 转发 内 容 
tm_time date 转发 时 间 
原 微 博 ID 号 ,外 键 。 来 自 tb_microblog 
mb_id int 11 
表 中 
7 " 原 微 博 的 用 户 ID 号 ,外 键 。 来 自 tb_ 
uid int 11 
user 表 中 
表 12-8 关注 信息 表 tb_follow 
字段 名 数据 类 型 | 字段 大 小 | 是 否 主键 | 是 否 可 为 空 说 明 
关注 ID 号 ,主键 , 自 增 量 。 用 来 唯一 
AN A 
M iM Bond Na: | 标识 一 组 关注 信息 的 编号 
fw_time date 关注 时 间 
fans_id int 11 粉丝 ( 即 关注 我 的 用 户 ) 的 ID 号 
idol id int 11 关注 用 户 ID 号 
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这 些 数据 库 表 可 以 在 MySQL 的 Workbench 中 创建 ,也 可 以 使 用 SQL 脚本 文件 来 创建 。 
本 实例 将 使 用 mobile-blog. sql 脚本 语句 文件 来 创建 ,具体 操作 见 12. 2. 2 节 中 描述 。 


12.2.2 MySQL 安装 配置 和 微 博 系统 数据 库 创 建 


MySQL 数据 库 环 境 搭建 分 为 MySQL 服务 器 安装 、 服 务 器 配置 和 MySQL 专用 的 数据 库 
设计 工具 Workbench 的 安装 三 部 分 。 在 MySQL 数据 库 环境 搭建 好 了 之 后 ,就 可 以 利用 
mobile-blog. sql 脚本 文件 来 创建 数据 库 。 


1. 安装 MySQL 服务 器 


从 网 络 上 下 载 MySQL 的 安装 文件 mysql-essential-5. 1. 51-win32. exe, 并 运行 此 文件 , 具 
体 安装 步骤 如 下 。 

(1) 运行 mysql-essential-5. 1. 51-win32. exe 程序 ,出 现 如 图 12-2 所 示 的 安装 向 导 。 

(2) 单 击 Next 按钮 ,进入 下 一 页 向 导 , 在 该 页 中 可 选择 安装 类 型 ,有 Typical( 典 型 安装 ， 
是 默认 选项 ) .Complete( 完 全 安装 )、Custom (用 户 自 定义 安装 ) 三 个 选项 ,这 里 选择 Typical, 

(3) 再 单 击 Next 按钮 ,选择 安装 路 径 , 本 实例 使 用 向 导 默 认 的 安装 路 径 。 然后, 单 击 
Install 按钮 开始 安装 。 

(4) 在 安装 向 导 中 ,一 直 单 击 Next 按钮 ,直到 完成 ,如 图 12-3 所 示 。 


Welcome to the Setup Wizard for MySQL à Wizard Completed 
Server 5.1 


Setup has finished instaling MySQL Server 5.1, Chck Finish to 
ex the wizard, 

The Setup Wizard wil instal MySQL Server 5,1 release 5.1.51 

on your computer. To continue, cick Next. 


[V] Configure the MySQL Server now 

Paesi ae ord config. 
file, setup a Windows service running on a dedicated port 
andi s he pasmerd or he Too cun. 


WARNING: This program is protected by copyright law. 


C Ce 


图 12-2 MySQL 安装 向 导 图 12-3 MySQL 安装 向 导 完 成 对 话 框 


2. MySOL 服务 器 配置 步骤 


在 完成 MySQL 服务 器 安装 之 后 ,要 根据 应 用 的 需要 对 其 进行 适当 的 配置 。 下 面 通过 图 
例 说 明 本 实例 对 MySQL 服务 器 的 配置 。 

CD 启动 配置 向 导 。 如 果 在 图 12-3 中 勾 选 了 Configure the MySQL Server now 项 ,在 单 
击 Finish 之 后 会 自动 进入 MySQL 服务 器 配置 向 导 。 如 果 没 有 勾 选 此 项 , 则 在 “开始 "菜单 的 
“程序 ”中 选择 MySQL MySQL Server 5. 1>MySQL Server Instance Configuration Wizard, 进 入 
MySQL 的 服务 器 配置 向 导 , 如 图 12-4 所 示 。 然 后 单 击 Next 按钮 。 

(2) 重新 配置 实例 。 如 果 以 前 已 经 安装 了 MySQL Server, 现 在 要 重新 配置 时 , 则 出 现 如 
图 12-5 所 示 的 向 导 , 在 此 对 话 框 中 选择 Reconfigure Instance 项 ,然后 单 击 Next 按钮 。 如 果 
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是 新 安装 MySQL Server 不 会 出 现 这 一 步骤 。 


Then Configuration word 0 Qo NN Instance Configuration Ward = O a 
Configuration Wizard 1.0.17.0 Configure the MySQL Server 51 server instance. | 
Trenton weard wi tom you to configure Please choose a maintenance option. 


1 server instance. 
dic Nest. | 
G Reconfigure Instance 
Select this option to create a new configuration for the. 
instance. This will replace the current configuration and restart 
A = 


C Remove Instance 


Pu leeren to aap Dea bulet m n 
file and to uninstall the Windows seice. 


图 12-4 MySQL 服务 器 配置 向 导 图 12-5 重新 配置 MySQL 服务 器 选择 向 导 


G) 选择 配置 类 型 。 在 此 向 导 页 选择 Detailed Configuration 选项 ,如 图 12-6 所 示 。 然 后 
单 击 Next 按钮 。 

(4) 选择 服务 器 类 型 。 在 此 向 导 页 选择 Server Machine 选项 ,使 得 将 MySQL Server 安 
装 在 网 络 的 服务 器 中 ,如 图 12-7 所 示 。 然 后 单 击 Next 按钮 。 


[MySQL Server Instance Configuration Wizard 0 sos UEM Server Instance Configuration Wizard m x 
MySQL Server Instance Configuration MySQL Server Instance Configuration. 
Configure the MySQL Server 5:1 server instance. Configure the MYSQL Server 51 server instance. 


Please select a configuration type. Please select a server type. This will influence memory, disk and CPU usage. 


C Developer Machine 


This is a development machine, and many other applications will 
be run on it. MYSQL Server should only use a minimal amount of 
memory. 


G Detailed Configuration. 


Choose this configuration type to create the optimal server 
setup for this machine. 


Gc 
matene e 
C Standard Configuration an SQLwil have. 
D Use this only on machines that do not already have à MySQL 
server installation. This will use a general purpose configuration C Dedicated MySQL Server Machine 
for the server that can be tuned manually. mer e to run the MYSQL Database Server. No 
Such as a web or mail server, will be run. MySQL 
Sune o o ak wal manang. 
EL | au | EE Loewe | 
12-6 选择 配置 类 型 向 导 页 12-7 选择 服务 器 类 型 向 导 页 


(5) 选择 数据 库 用 法 。 在 此 向 导 页 选择 Multifunctional Database 选项 ,如 图 12-8 所 示 。 
然后 单 击 Next 按钮 ,进入 下 一 页 ,该 页 将 对 InnoDB Tablespace 进行 配置 , 即 为 InnoDB 数据 
库 文件 选择 一 个 存储 空间 ,本 实例 不 对 其 作 任 何 修改 ,继续 单 击 Next 按钮 。 

(6) 设置 网 站 的 访问 量 , 即 可 同时 连接 用 户 数 。 在 此 向 导 页 中 选择 Manual Setting 项 ,如 
图 12-9 所 示 。 然 后 单 击 Next 按钮 。 

CD 设置 网 络 选项 。 在 此 向 导 页 中 勾 选 Enable TCP/IP Networking 和 Enable Strict 
Mode 选项 ,使 用 默认 端口 号 3306, 如 图 12-10 所 示 。 然 后 单 击 Next 按钮 。 

(8) 设置 字符 集 。 这 一 步 比较 重要 ,只 有 正确 地 设置 应 用 系统 的 字符 集 , 在 运行 时 才能 正 
常 显 示 汉 字 。 在 此 向 导 页 中 选择 Manual Selected Default Character Set/Collation 选项 ,并 且 
在 Character Set 中 选择 utf8 ,如 图 12-11 所 示 。 然 后 单 击 Next 按钮 。 
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MySQL Server Instance Configuration. 
Configure the MYSQL Server 51 sever instance, 


Configure the MySQL Server 5:1 server instance, 


Please select the database usage. Please set the approximate number of concurrent connections to the server. 
C Decision Support (DSS)/OLAP 
Select this option for database applications that wil not require. 


MER em 
cese 


(€. Multifunctional Database. 
General purpose databases. This will optimize the server for the 
use of the fast transactional InnoDB storage engine and the. 
high speed MyISAM storage engine. 


C Transactional Database Oniy 


Optimized for application servers and transactional web 
applications. This will make InnoDB the main storage engine. 
Note that the MYISAM engine can still be used. 


C Online Transaction Processing (OLTP) 
Choose this option for highly concurrent applications that may 
have at any one time up to 500 active connections such as 
heavily loaded web servers. 


一 二 二 和 二 汪汪 各 
EN — sj 
Loma [mero] ce | Lee [owe] owe | 


图 12-8 选择 数据 库 用 法 向 导 页 图 12-9 选择 可 连接 用 户 数 向 导 页 


‘Suited for simple web applications, monitoring or logging 
Z applications as well as analysis programs. Only the 
non-transactional MyISAM storage engine will be activated. 


MySQL Server Instance Configuration. 
Configure the MYSQL Server 5.1 server instance. Configure the MYSQL Server 51 server instance, 


Please set the networking options. Please select the default character set. 


IV. Enable TCP/IP Networking C Standard Character Set 


Enable this to allow TCPAP connections. When disabled, only Makes Latini the default charset. This character set is suited for 
local connections through named pipes are allowed. English and other West European languages. 


Port Number: T >] [7 Add firewal exception tor this port C Best Support For Multilingualism 


Make UTF the default character set. This is the recommended 
Character set for storing text in many different languages. 
Please set the server SQL mode. 


F? Enable Strict Mode | G Manual Selected Default Character Set / Collation 
This option forces the server to behave more We a traditional | Please specity the character set to use, 
database server. Iti recommended to enable this option. « EL  — 


ime | ewe | —m | 一 cam | 
12-10 设置 网 络 选项 向 导 页 12-11 设置 字符 集 向 导 页 


(9) 设置 MySQL 在 Windows 操作 系统 中 的 选项 。 勾 选 Include Bin Directory in Windows 
PATH 项 ,将 MySQL 的 安装 文件 夹 路 径 添加 到 Windows 的 环境 参数 path 中 ,如 图 12-12 所 示 。 
然后 单 击 Next 按钮 。 

(10) 设置 MySQL 的 安全 选项 。 如 果 是 重新 配置 MySQL, 则 勾 选 Modigy Security 
Settings 项 ,可 以 修改 密码 ,如 图 12-13 所 示 。 如 果 是 全 新 安装 MySQL. Hill EL 14 3E. New root 
password 和 Confirm( 输 入 root 密码 和 确认 密码 ) 两 个 编辑 框 。 如 果 不 设置 密码 , 则 留 空 即 可 。 在 
此 页 ,输入 密码 为 “root”, 并 勾 选 Enable root access from remote machines。 然 后 单 击 Next 按钮 。 
Instance Configuration Wizard —— Ex 


MySQL Server Instance Configuration. 
Configure the MYSQL Server 5.1 server instance. 


Instance Configuration Wizard 
MySQL Server Instance Configuration. 
Configure the MYSQL Server 511 sever instance. 


Please set the Windows options. Please set the security options. 


Ff Install As Windows Service f. Modify Security Settings 


$ This is the recommended way to run the MySQL 
fr È server on Windows. 


| 


Current root password: [7 


New root password: 


s option to Incude the directory containing 
he server / chent executables in the Windows PATH 
variable so they can be called from the command line. 


ma | ewe | | 
12-12 iE Windows 选项 向 导 页 1213 设置 安全 选项 向 导 页 
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(11) 执行 配置 。 在 完成 上 述 设置 后 ,在 此 向 导 页 单 击 Execute 按钮 ,将 逐 项 进行 执行 设 
置 ,执行 通 过 则 在 此 小 项 前 打 钧 ,执行 不 通过 则 打 叉 ,如 图 12-14 所 示 。 当 所 有 项 都 打 钓 后 即 
配置 成 功 , 单 击 Finish 按钮 完成 配置 。 


MySQL Server Instance Configuration 
Configure the MySQL Server 5.1 server instance. 


Processing configuration ... 


B Prepare configuration. 
回 Write configuration file (C:\Program FiesMySQLWMYSQL Server Slry.m) 
Ø Start service 

B Apply security settings 


12-14 ”完成 配置 向 导 页 


在 MySQL 服务 器 的 配置 中 ,比较 常见 的 错误 是 不 能 “Start service”, 出 现 这 个 错误 通常 
是 以 前 有 安装 MySQL 服务 器 的 情形 。 解 决 的 办 法 是 ,首先 检查 是 否 按 前 面 的 步骤 进行 配置 ; 
其 次 是 确定 之 前 的 密码 是 否 有 修改 ; 如 果 不 能 解决 问题 ,可 以 将 MySQL 安装 文件 夹 下 的 
data 文件 夹 备份 (如 果 需 要 保留 以 前 的 数据 库 表 ) ,将 以 前 安装 的 MySQL 服务 器 彻底 印 载 掉 ， 
重新 安装 MySQL, 再 将 备份 的 data 文件 夹 移 回来 ,然后 再 重启 MySQL 服务 就 可 以 了 ,这 种 
情况 下 ,可 能 需要 将 数据 库 检 查 一 下 ,然后 修复 一 次 ,防止 数据 出 错 。 


3. 安装 数据 库 设 计 工具 MySOL Workbench 


MySQL Workbench 是 MySQL AB 发 布 的 可 视 数 据 库 设计 工具 。 这 个 工具 是 设计 
MySQL 数据 库 的 专用 工具 , 它 拥有 很 多 的 功能 和 特性 。 

安装 MySQL Workbench, 只 需 运行 mysql-workbench-gpl-5. 2. 28-win32. exe 程序 ,然后 
按照 安装 向 导 逐 步 进行 即 可 。 


4. 导入 数据 


创建 数据 库 表 的 方式 通常 有 两 种 。 一 种 是 通过 MySQL Workbench 工具 创建 并 录入 数 
据 , 另 一 种 是 通过 已 有 的 SQL 脚本 文件 进行 生成 。 本 书 为 大 家 提供 了 一 个 SQL 脚本 文件 , 因 
此 可 使 用 第 二 种 方式 进行 数据 库 表 的 创建 并 导入 数据 。 在 本 书 的 源 代码 文件 夹 Ch12 中 存 有 
生成 本 实例 数据 库 表 的 SQL 脚本 文件 mobile-blog. sql。 注 意 , 在 MySQL Workbench 中 , 利 
用 SQL 脚本 创建 数据 库 表 时 ,其 脚本 文件 名 及 其 存放 路 径 不 能 包含 中 文 名 。 

下 面 介绍 创建 数据 库 及 导入 数据 操作 过 程 。 

CD 启动 MySQL Server。 注 意 ,在 启动 MySQL. Workbench 之 前 必须 先 启动 MySQL 
Server。 方 法 是 在 “开始 ”菜单 的 “程序 ”中 选择 MySQL — MySQL Server 5. 1—> MySQL 
Command Line Client, 进入 命令 行 状态 ,输入 MySQL Server 的 进入 密码 (本 实例 密码 为 
root) ,出 现 如 图 12-15 所 示 的 信息 表示 MySQL Server 启动 完成 。 


429 


A 


SS Android 应 用 开发 教程 


3^ CAProgram Files\MySQL\MYSQL Server 5.1\bin\mysql.exe = 


图 12-15 进入 MySQL Server 命令 行 界面 


) 启动 MySQL Workbench。 方 法 是 在 “开始 ”菜单 的 “程序 ”中 选择 MySQL MySQL 
Workbench 5.2 CE, 即 可 进入 MySQL Workbench 的 欢迎 界面 ,如 图 12-16 所 示 。 在 欢迎 界 
面 停留 片刻 后 ,自动 进入 MySQL. Workbench 工作 界面 ,如 图 12-17 所 示 。 


Welcome to MySQL Workbench 


多 SQL Development Data Modeling o Server Administration 


图 12-16 MySQL Workbench 的 欢迎 界面 


Crate ER Model rrom SQt Scrpt 


图 12-17 MySQL Workbench 的 工作 界面 


(3) 进入 SQL Development, Xi; "localhost/User: root Host; localhost; 3306" Cin E] 12-17 
所 示 标 记 处 ) ,进入 MySQL. Workbench 数据 库 表 管理 窗口 。 
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(4) 选择 菜单 File* Open SQL Script... ,查找 文件 mobile-blog. sql 并 打开 ,如 图 12-18 
所 示 。 


/* 
SQLyog Commu 
M 5.1.81 


T > 


©  /*140101 SET NAMES utf8 */; 


9* /*140101 SET SQL MODE-' **/; 


i» *  /*!48014 SET QOLD UNIQUE CHECKS-GeUNIQUE CHECKS, UNIQUE CHECKS-0 */; 
12e  /*!48014 SET QOLD FOREIGN KEY CHECKS-GeFÜREIGN KEY CHECKS, FOREIGN KEY CHECKS-9 */; 

13 ^  /*!40101 SET OLD SQL MODE-GGSQL MODE, SQL MODE-'NO AUTO VALUE ON ZERO' */; 

14 *  /*!40111 SET QOLD SQL NOTES-GéSQL NOTES, SQL NOTES-O */; 

18 * CREATE DATABASE IF NOT EXISTS "microblog' DEFAULT CHARACTER SET utf8; 

16 

17 * USE "microblog'; 

18 

19 — /*Table structure for table ^tb admin * 

20 

21 * DROP TABLE IF EXISTS "tb admin; 

22 

23 * EJCREATE TABLE ^tb admin ( 

24 "adm id^ int(11) NO 

25 adm name" va 

26 adm password" v. 

E adm lastLoginTime T 

28 adm lastLoginIp" varchar(S0) DEFAULT NULL, 2 


图 12-18  mobile-blog. sql 文件 内 容 


(5) 执行 mobile-blog. sql 文件 。 在 MySQL Workbench 的 工具 栏 中 单 击 * 执 行 SQL 脚本 
工具 ”按钮 ,如 图 12-19 所 示 。 


图 12-19 MySQL Workbench 工具 栏 


执行 完成 后 即 可 在 数据 库 中 看 到 新 创建 的 数据 库 microblog ,如 图 12-20 所 示 。 


EFEFEF] 


Æ 12-20 microblog 数据 库 


在 mobile-blog. sql 脚本 文件 中 , 既 包括 Create Database 和 Create Table 命令 创建 数据 库 
表 , 也 包括 Insert 命令 向 数据 表 中 插入 了 部 分 数据 。 所 以 在 执行 mobile-blog. sql 之 后 , 既 创 
建 了 数据 库 表 ,也 完成 了 数据 的 导入 。 可 以 打开 其 中 的 数据 表 , 如 tb_microblog 表 , 可 以 看 到 
表 中 的 数据 ,如 图 12-21 Bros. 
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lic o o IEE 2B 3:33 4191 Fetched 1000 records, more available 


mb content 
RARES: SAIISGEBAIIBSETRISNK. EXETSIDMEITK EREE 

BT. 
RBEXTOBRERBESDUNSITSARIDEEHERT. DEEETARENES SIEERESEÜREXBB. HAT 
menem 
Yo pateo fvertemante la pelota contra el lateral con ineno de pagarte a los carteles de Pbicdad pero ia verdad es que le pegue muy 
MMEA, SER EBSEDPIL MARSAC. S0S€ES5 BIETAHEI. PETETA: DRAPA SAR) 
SOTER, WS. US. FIRER. L-HR FITE PHIR! RORA. HCHLIIRTI  CRLAERS 
Loro] 

[oL o mu 
H7— 2 ERENIESAS- 
IHRE. SUD. RUM. RERA BEDRESH. RÉESETRBA. £287 
名 有 点 本 长。 
BEKTSHEERUEUB. fAWRFINEXA: diüdptMORUHNONY- 
OREOHSKISERIB : Msc" RERBA 我 下 要 了 I - LEHRER QR T 
RINRIN REFF T. 
全 二 要 星 信 一 点 ， 一 个 好 的 耻 朋 人 ， 或 者 和 朋 9 本人， 商定 全 社员 一 个 和 8 好 人 技 S 的 。 这 就 DOP。 


12-21 tb microblog 表 中 数据 


12.2.3 Web 应 用 服务 器 的 配置 和 部 署 

在 作为 Web 应 用 服务 器 的 计算 机 上 安装 Tomcat。 本 实例 中 ,将 开发 机 作为 Web 应 用 服 
务 器 ,在 本 机 上 安装 Tomcat 服务 器 ,Tomcat 的 安装 步骤 及 其 在 Eclipse 中 的 设置 参见 10. 2.1 
节 。 接 下 来 进行 应 用 服务 器 配置 和 部 署 


1. 数据 源 配 置 


为 了 使 得 Tomcat 服务 器 与 MySQL 数据 库 进行 连接 , Tomcat. 中 必须 有 MySQL 的 数据 库 驱 
动 。 添 加 MySQL 的 数据 库 驱 动 非常 简单 ,只 需要 向 Tomcat. 安装 文件 夹 的 lib FLR FHA 
JAR 包 mysql-connector-java-5. 1. 13-bin. jar 即 可 ,该 JAR 包 可 以 从 网 络 上 免费 下 载 获得 。 


2. Web 应 用 程序 部 署 


章 着 重 介绍 手机 客户 端 程序 的 开发 ,所 以 不 对 Web 浏览 器 端的 程序 作 详 细 介 绍 ,只 是 
直接 将 Web 浏览 器 端的 应 用 程序 压缩 文件 包 MobileBlog. war 复制 到 Tomcat 安装 文件 夹 的 
webapps 文件 夹 下 ,该 文件 可 从 本 书 的 源 代码 文件 夹 的 Ch12 子 文件 夹 中 得 到 。 这 里 的 . war 
格式 文件 是 Java 的 归档 文件 , 它 用 于 封装 Web 程序 模块 。 

本 书 的 Tomcat 的 安装 文件 夹 路 径 为 E: NV apache-tomcat-7. 0. 11, 所 以 应 该 将 
MobileBlog. war 文件 复制 到 EE:\ apache-tomcat-7. 0. 11\webapps 文件 夹 下 即 可 。 


(12.3 手机 客户 端的 编程 实现 
— 
根据 9. 5 节 介绍 的 应 用 开发 步骤 ,逐步 进行 12. 1. 1 节 中 功能 模块 的 实现 。 


12.3.1 用 户 界面 设计 及 资源 准备 


首先 ,根据 本 应 用 项 目的 功能 规划 出 需要 的 用 户 界面 数目 、 界 面 完 成 的 功能 、 相 互 的 跳 转 
关系 ,使 得 开发 人 员 对 整个 应 用 系统 有 个 概要 理解 。 
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其 次 ,对 每 一 个 用 户 界面 进行 初步 设计 : 画 出 草图 ,从 而 得 到 每 个 界面 所 需要 的 控件 、 颜 
色 .文字 串 、 图 片 .图标 以 及 音乐 等 相关 的 资源 。 

再 次 ,根据 每 个 界面 的 需要 ,准备 相关 的 文字 、 图 片 .颜色 .音乐 等 资源 。 

上 述 这 些 都 是 在 进入 详细 开发 前 的 准备 工作 ,开发 人 员 必 须 完 成 这 一 步 ,才能 进入 后 续 的 
代码 编写 工作 。 


12.3.2 应 用 项 目 


在 Eclipse 中 新 建 一 个 Android Application 项 目 MobileBlog_Android, 然 后 进行 开发 。 
本 书 中 提供 了 已 完成 的 项 目 源码 ,可 从 本 书 源 代码 的 Ch12 文件 夹 中 获得 ,然后 通过 Import 
将 其 载 人 Eclipse 中 。 


1. Import 项 目的 操作 步骤 
(1) 在 Eclipse 中 ,选择 菜单 File— Import... ,打开 Import 对 话 框 ,展开 General, 选择 


Existing Projects into Workspace 项 ,如 图 12-22 所 示 。 然 后 单 击 Next 按钮 。 


Select N 
Create new projects from an archive file or directory. [eng 


Select an import source: 


type fiter tot — 
4 区 General E 
多 Archive File 
(Ei Existing Projects into Workspace. 
G, File System 
E, Preferences 
bes 
[27371 
b © Java EE. 


b © Plug-in Development. 
b © Remote Systems 

b © Run/Debug 

b © Tasks 


= - 


@ nra erm | Frish Cancel 


12-22 Import 对 话 框 


(2) 在 Import Projects 页 中 查找 到 项 目的 存放 位 置 ,本 书 存放 于 E:\AndroidCode\Ch12 


下 ,如 图 12-23 所 示 。 然 后 单 击 Finish 按钮 , 即 可 将 本 书 提供 的 应 用 项 目 加 载 到 Eclipse 的 当 
前 Workspace 中 。 


2. 应 用 项 目的 目录 结构 


在 Eclipse 的 Package Explorer 中 应 该 有 MobileBlog Android 和 Servers 两 个 项 目 , 如 
图 12-24 所 示 ,手机 微 博客 户 端 才能 正常 运行 ,其 中 Servers 项 目 是 由 配置 Tomcat 服务 器 和 
部 署 微 博 系统 的 Web 应 用 程序 时 生成 的 。 在 此 ,只 关心 MobileBlog_Android 项 目 , 它 是 手机 
微 博客 户 端的 程序 项 目 。 
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Import 
Import Projects | 
Select a directory to search for existing Eclipse projects. [7 
@ Select root directory: E\AndroidCode\Ch12\MobileBlog Andrc (Browse. | 
© Select archive file: ][ aowe- ] 
Projects: 


> mÀ Android 21 
4 (B src 
> [B com.sample.activiy 
> [B comsamplebo 
> [B com.sample.common 
> BB com.sample.connection 
b & gen [Generated Java Files] 


MobileBlog Android (EMAndroidCode|Ch12WobileBl ET 


El Copy projects into workspace. » mÀ Android Dependencies 
Working sets b 

: : » & bin. 
回 Add project to working sets Pres 


Working sets: -| select.. 回 AndroidManifestml 


图 12-23 选择 要 载 信 的 项 目 文件 夹 12-24 ”Eclipse 中 的 项 目 目录 


展开 res 目录 ,可 看 到 本 项 目 中 使 用 了 若干 图 片 资 源 和 预定 义 字 符 资 源 ,13 个 布局 文件 ,如 
图 12-25 所 示 。 展 开 src 目录 ,可 看 到 本 项 目 中 的 逻辑 代码 分 别 使 用 了 4 个 包 , 如 图 12-26 所 示 。 
其 中 ,在 com. sample. activity 包 中 是 项 目的 全 部 Activity 的 类 代码 定义 ,在 com. sample. bo 包 中 
是 项 目 中 与 业务 有 关 的 对 象 存 取 方 法 类 定义 ,在 com. sample. common 包 中 是 项 目 里 面 公共 的 常 
量 和 工具 类 定义 ,com. sample. connection 包 中 是 项 目 与 网 络 进行 通信 连接 的 类 定义 。 


list item sel color.png 
B list selectorxml 
Illi pic login bg.png 
ij tab. collectior.png 4 [lj com.sample.activity 
ij tab homepage.png > [i] HomePageActivityjava. 
ij tab personinfo.png » DD LoginActivityjava 
[ij tab_searchpng » MainActivityjava 
[ij tab writemb.png » [i) MicroBlogDetailActivity java 
» © drawable-hdpi » [D MyfavorateActivityjava 
b © drawable-ldpi » D NewBlogActivit 
b © drawable-mdpi > [D PersoninfoActivityjava 
b © drawable-xhdpi 》 国 RegisterActivityjava 
a > [J) SearchActivityjava 
H collection itemaml > [D UserBlogActivity java. 
B collection listxml > [D UserCommentsActivity java. 
B dialog microblog detail operatexml 4 [Bi com.sample.bo 
E homepage itemxml > D Imagelnfojava. 
E homepage listxml » [J) MicroBlogHP java. 
B loginxxml > D Userjava 
E mainxml » D Userinfojava 
4 [i com.sample.common 
> [À Base64java 
» [D Constantsjava 
» [) Localstoragejava 
4 i com.sample.connection 
> BD HttpCommunicationjava 
» [) HttpCommunicationBitmap java 
b 9 gen [Generated Java Files] 


图 12-25 项 目的 资源 目录 内 容 图 12-26 项 目的 src 目录 内 容 


第 12 章 ”应 用 项 目 开发 实例 


12.3.3 功能 实现 解析 
1. 各 功能 模块 的 实现 类 简介 
CD. 登录 模块 由 LoginActivity 类 实现 。 该 Activity 是 手机 微 博 运行 后 首先 被 启动 的 


Activity。 

(2) 注册 模块 由 RegisterActivity 类 实现 。 该 Activity 从 LoginActivity 中 启动 。 

(3) 个 人 中 心 模块 由 MainActivity 类 实现 。 该 Activity 从 LoginActivity 中 启动 , 它 继承 
A TabActiity 类 ,将 手机 微 博 的 各 主要 功能 以 选项 卡 的 形式 显示 在 屏幕 上 ,并 对 选项 卡 进行 
逻辑 控制 。 

(4) 手机 客户 端 首页 模块 由 HomePageActivity 和 MicroBlogDetailActivity 类 实现 ,其 
中 ,HomePageActivity 类 显示 若干 博客 的 列表 ,并 可 以 对 列表 进行 分 页 ,这 些 博客 包括 当前 用 
户 发 布 或 转发 的 所 有 博客 及 当前 用 户 所 关注 的 用 户 发 布 或 转发 的 所 有 博客 。 单 击 任 一 博客 列 
表 项 即 可 打开 该 博客 详细 信息 。MicroBlogDetailActivity 类 显示 博客 的 详细 信息 ,并 可 对 该 
博客 进行 转发 .评论 和 收藏 。 

(5) 发 微 博 模 块 由 NewBlogActivity 类 实现 。 在 该 Activity 中 用 户 可 以 写 博客 ,本 客户 端 
允许 用 户 写 150 个 字符 的 博客 内 容 。 在 编辑 区 的 下 方 实时 给 出 还 能 输入 的 字符 个 数 ,以 提示 
用 户 注意 。 

(6) 个 人 信息 模块 由 PersonInfoActivity, UserBlogActivity 和 UserCommentsActivity 类 
实现 。 其 中 ,PersonInfoActivity 类 显示 当前 用 户 的 主要 信息 ,包括 昵称 \ 年 龄 ,最 后 的 登录 时 
间 和 发 表 的 博客 数 、 关 注 的 用 户 数 和 被 其 他 用 户 关 注 即 粉丝 数 信 息 。 单 击 博客 数 , 可 进入 
UserBlogActivity; 单 击 关注 数 和 粉丝 数 , 可 进入 UserCommentsActivity。 

(7) 收藏 管理 模块 由 MyFavorateActivity 类 实现 。 该 Activity 以 列表 的 方式 显示 被 当前 
用 户 所 关注 的 所 有 用 户 列 表 , 当 长 按 某 项 关注 项 时 ,会 出 现 删除 此 关注 项 的 对 话 框 。 

(8) 查找 模块 由 SearchActivity 类 实现 。 在 该 Activity 的 编辑 框 内 输入 要 查找 的 用 户 名 
或 用 户 名 的 前 几 个 字 串 , 单 击 “查找 ?图 标 , 即 可 在 网 络 服务 器 中 查找 到 所 有 以 输入 字符 开头 的 
用 户 名 。 当 在 某 条 用 户 上 长 按时 ,会 出 现 关注 该 用 户 的 对 话 框 。 


2. 功能 模块 与 服务 器 的 通信 实现 


本 手机 客户 端 程序 与 服务 器 数据 库 的 数据 通信 是 通过 接口 ,采用 HTTP 请 求 获取 网 络 服 
务 器 资源 。 通 信 接 口 以 UTF-8 进行 编码 ,使 用 post 请 求 方式 ,数据 返回 值 采用 普通 字符 串 或 
JSON 格式 进行 封装 。 

问 一 下 : 

什么 是 JSON 格式 ? 

JSON(JavaScript Object Notation) 是 一 种 轻 量 级 的 数据 交换 格式 。 它 基于 JavaScript 
(Standard ECMA-262 3rd Edition-December 1999) 的 一 个 子 集 ,采用 完全 独立 于 语言 的 文本 
格式 ,易于 人 阅读 和 编写 ,同时 也 易于 机 器 解析 和 生成 。 这 些 特性 使 得 JSON 成 为 理想 的 数据 
交换 语言 。 
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1) 与 服务 器 端 通信 接口 协议 
在 本 实例 中 ,调用 接口 方法 是 : 


String HttpCommunication. sendPostHttpRequest(String url, List < NameValuePair > params); 


其 中 ,输入 参数 1,String url 是 接口 的 URL; 输入 参数 2,List params 是 post 到 服务 器 的 
参数 列表 。 这 些 参数 是 key/value 的 值 对 列表 。 
返回 值 : 普通 字符 串 或 者 JSON 格式 的 字符 串 。 
K 12-9 一 表 12-23 给 出 手机 客户 端 各 应 用 模块 的 接口 协议 说 明 。 
表 12-9 登录 模块 接口 


接口 说 明 登录 接口 
URL 地 址 http://ip:port/MobileBlog/ClientUserAction!login. action 

参数 列表 

参数 名 类 型 描述 值 条 件 备注 
user. name String 用 户 名 必 填 测试 账号 userl 
user. password String | 用 户 密 码 必 填 测试 密码 user 
返回 参数 

参数 名 类 型 描述 

result String | 返回 的 字符 串 

返回 数据 格式 

字段 名 说 明 备注 


返回 一 个 字符 串 , 字 符 串 由 两 部 分 组 
success rec no È: "success "fH rec no. rec no 是 指 


该 用 户 所 在 的 数据 库 的 u_id 字段 值 


例如 : 一 个 用 户 的 记录 在 tb. user 表 里 ,u_id 
字段 的 值 是 3, 则 返回 的 值 为 “success_3” 


表 12-10 注册 并 判断 是 否 有 重复 用 户 模块 接口 


接口 说明 注册 时 ,判断 是 否 有 同名 的 用 户 
URL 地 址 http://ip:port/MobileBlog/ClientUserAction!isNameConflict. action 
参数 列表 
参数 名 类 型 描述 值 条 件 备注 
user. name String 用 户 名 必 填 用 户 注册 时 填 入 的 用 户 名 
返回 参数 
参数 名 类 型 描述 
result String 返回 的 字符 串 
返回 数据 格式 
字段 名 说 明 备注 
true 说 明 系 统 中 有 同名 的 用 户 


false 说 明 系统 中 没有 同名 的 用 户 
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X121 上 传 照片 模块 接口 
接口 说 明 用 户 通过 客户 端 上 传 图 片 


URL 地 址 http://ip:port/MobileBlog/UploadImageAction!upload. action 


参数 列表 


参数 名 类 型 描述 值 条 件 备注 
filename String | 文件 名 必 填 | 文件 的 全 路 径 和 文件 名 
filebody String | 文件 的 内 容 必 填 | 应 该 用 Base64 进行 编码 
返回 参数 

参数 名 类 型 描述 

result String | 返回 的 字符 串 
返回 数据 格式 

字段 名 说 明 备注 
success 文件 上 传 成 功 
error 文件 上 传 失败 


表 12-12 用 户 注册 模块 接口 


接口 说明 新 用 户 注册 的 接口 
接口 地 址 http://ip:port/MobileBlog/ClientUserAction! register. action 

输入 参数 

参数 名 类 型 描述 值 条 件 备注 
user, name String 注册 的 用 户 名 必 填 
user, password String 用 户 的 密码 必 填 
user, trueName String 用 户 的 真实 姓名 必 填 
user, age String 用 户 年 龄 必 填 
user, picture String 上 传 图 片 的 名 称 必 填 
返回 参数 

参数 名 类 型 描述 

result JSON 数据 | 见 返 回 参 数 说 明 。 如 返回 数据 错误 , 则 根据 错误 代码 构建 JSON 数据 
返回 JSON 数据 格式 

字段 名 说 明 备注 
status 操作 的 状态 
showNote 操作 的 提示 信息 
返回 JSON 数据 格式 举例 
{f"status":"l","showNote":" 用 户 注册 成 功 "} 
返回 错误 码 
错误 码 说 明 
=j 用 户 已 存在 
0 注册 失败 
返回 错误 码 JSON 格式 举例 
{"status":" 一 1","showNote":" 用 户 已 经 存在 "} 


","showNote" :" 注 册 失 败 "} 


{"status": 
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表 12-13 ”获取 微 博 列表 模块 接口 


接口 说 明 获取 微 博 列 表 接 口 
接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction!getMicroBlogInfo. action 

输入 参数 

参数 名 类 型 描述 值 条 件 备注 
pageNow Sting | 当前 列表 页 码 必 填 用 来 做 翻 页 操作 ,记录 当前 页 码 
userld String | 用 户 id 必 填 表示 获取 的 是 该 用 户 的 微 博 
返回 参数 

参数 名 类 型 描述 

JSON 数据 ”|JSON 数据 | 见 返回 参数 说 明 。 如 返回 数据 错误 , 则 根据 错误 代码 构建 JSON 数据 

返回 数据 格式 

字段 名 说 明 备注 
pageCount 记录 分 页 后 的 总 页 数 
results 返回 的 博客 列表 参加 下 面 “results 说 明 ” 部 分 
results 说 明 

字段 名 说 明 备注 
content 博客 内 容 字符 串 类 型 
microBlogId 博客 的 ID 整数 
time 博客 发 表 的 日 期 年 -月 -日 格式 
userId 用 户 ID 发 表 该 博客 的 用 户 ID 
userName 用 户 名 发 表 该 博客 的 用 户 名 称 
用 户头 像 图 片 的 文件 名 用 默认 头像 ,该 值 为 "user_headphoto. 
返回 JSON 数据 格式 举例 


("pageCount" ; "178" , "results" :[{"content":"jhgg","microBlogId" :1205, "time":"2012-07-13","userld": 


DERE "on ; "on 


67 ,"userName" : "as" ," userPhoto":;" user headphoto. png")  ( " content" :" jjhgcv "." microBlogld" : 1206 , 


"time" ; "2012-07-13" ," userId" :67, "userName" ; "as" ,"userPhoto" ;" user. headphoto. png") ]) 


R 12-14 ”转发 微 博 模块 接口 
接口 说 明 转发 微 博 接口 


接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction! microBlogTransmit. action 


输入 参数 


参数 名 类 型 描述 值 条 件 备注 
ea micro String ”| 被 转发 微 博 ID 必 填 
Blog. id 


transmit. user, id | String ”| 被 转发 微 博 用 户 ID 必 填 


transmit. content| String ”| 被 转发 微 博 的 内 容 必 填 


返回 参数 

参数 名 类 型 描述 

result String | 见 返 回 参 数 说 明 
返回 数据 格式 

字段 名 说 明 字段 类 型 备注 
success 转发 成 功 | String 


表 12-15 发 表 微 博 评论 模块 接口 
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接口 说 明 发 表 微 博 评论 接口 
接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction!microBlogComment. action 
输入 参数 
参数 名 类 型 描述 值 条 件 备注 
comment. microBlog.id| String | 被 评论 微 博 ID 必 填 
comment, user. id Sting | 被 评论 微 博 用 户 ID 必 填 
comment. content String | 被 评论 微 博 的 内 容 必 填 
返回 参数 
参数 名 类 型 描述 
result String | 见 返回 参数 说 明 
返回 数据 格式 
字段 名 说 明 字段 类 型 备注 
Success 评论 成 功 | String 
表 12-16 ”收藏 微 博 模块 接口 
接口 说明 收藏 微 博 接 口 
接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction!microBlogCollection. action 
输入 参数 
参数 名 类 型 描述 值 条 件 备注 
collection. microBlog. id| String | 被 收藏 微 博 ID 必 填 
collection. user. id String “| 被 收藏 微 博 用 户 ID 必 填 
返回 参数 
参数 名 类 型 描述 
result String 见 返回 参数 说 明 
返回 数据 格式 
字段 名 说 明 字段 类 型 备注 
success 收藏 成 功 | String 
表 12-17 发 表 新 微 博 模块 接口 
接口 说 明 发 表 新 微 博 接口 
接口 地 址 http: //ip:port/MobileBlog/ClientMicroBlogAction! saveMicroBlog. action 
输入 参数 
参数 名 类 型 描述 值 条 件 备注 
microBlog. content String 微 博 内 容 必 填 
userId String 发 表 微 博 的 用 户 ID 必 填 
返回 参数 
参数 名 类 型 描述 
Tesult String 见 返回 参数 说 明 
返回 数据 格式 
字段 名 说 明 字段 类 型 备注 
Success 发 表 微 博 成 功 | String 
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表 12-18 显示 用 户 资料 模块 接口 


接口 说 明 从 服务 器 端 获取 某 个 用 户 的 资料 
接口 地 址 http://ip:port/MobileBlog /ClientMicroBlogAction!getUserInfo. action 

输入 参数 

参数 名 类 型 描述 值 条 件 备注 
userID String | 用 户 ID 必 填 
返回 参数 

参数 名 类 型 描述 

result String | 见 返 回 参 数 说 明 

Result 包含 的 数据 说 明 

字段 名 说 明 备注 
fansCount 粉丝 数 整 型 
idolCount 收听 人 数 整 型 
lastLoginTime | 上 次 登录 日 期 字符 串 : YYYY-MM-DD 
mbCount 以 发 表 微 博 数 整 型 
userAge 用 户 年 龄 整 型 
userId 用 户 编号 整 型 
userName 用 户 姓 名 Sm 
userPicture 用 户头 像 的 URL 字符 串 
返回 JSON 数据 格式 说 明 


{"results":[{"fansCount":7,"idolCount":13,"lastLoginTime":"2012-08-10","mbCount":9,"userAge": 
"28", "userld" :1, "userName" :"userl" ," userPicture" :"20110418221357. jpg") ]) 


表 12-19 关注 微 博 模块 接口 
接口 说明 关注 新 微 博 接口 


接口 地 址 http: //ip:port/MobileBlog/ClientMicroBlogAction! saveUserldol. action 


输入 参数 


参数 名 类 型 描述 值 条 件 备注 


follow. idol. id String | 被 关注 用 户 ID 必 填 


follow. fans. id String 关注 者 用 户 ID 必 填 


返回 参数 
参数 名 类 型 描述 
result String | 见 返 回 参数 说 明 
返回 数据 格式 
字段 名 说 明 字段 类 型 备注 


success 关注 成 功 | String 
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表 12-20 取消 关注 微 博 模 块 接口 
接口 说明 取消 关注 新 微 博 接口 


接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction! deleteUserlIdol. action 


输入 参数 


参数 名 类 型 描述 值 条 件 备注 
follow. idol. id String 被 关注 用 户 ID 必 填 
follow. fans. id String 关注 者 用 户 ID 必 填 
返回 参数 
参数 名 类 型 描述 
result String 见 返 回 参 数 说 明 
返回 数据 格式 
字段 名 说 明 字段 类 型 备注 
success 取消 关注 成 功 | String 


表 12-21 搜索 用 户 模块 接口 
接口 说 明 搜索 用 户 接口 


接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction! getMicroBlogInfo. action 


输入 参数 


参数 名 类 型 描述 值 条 件 备注 
pageNow String | 当前 列表 页 码 必 填 用 来 做 翻 页 操作 ,记录 当前 页 码 
à 用 于 搜索 的 关 
search String 键 字 必 填 
返回 参数 
参数 名 类 型 描述 
JSON 数据 |JSON 数据 | 见 返回 参数 说 明 。 如 返回 数据 错误 , 则 根据 错误 代码 构建 JSON 数据 


返回 数据 格式 


字段 名 说 明 备注 
pageCount 返回 记录 的 分 页 数目 
results 返回 符合 条 件 的 用 户 信息 列表 详 见 下 面 results 列表 数据 说 明 
results 说 明 
字段 名 说 明 备注 
fansCount 听众 数量 整数 
idolCount 收听 的 用 户 数 整数 
lastLoginTime | 最 后 一 次 登录 的 日 期 年 -月 -日 格式 
mbCount 发 表 博客 的 数量 整数 
userAge 用 户 年 龄 整数 
userId 用 户 ID 
userName 用 户 名 称 
userPicture 用 户 的 头像 文件 名 例如 : 用 默认 头像 ,该 值 为 “user_headphoto. png" 
返回 JSON 数据 格式 举例 
{" pageCount":" 5"," results": [{ " fansCount": 4," idolCount": 6," lastLoginTime":" 2011-05-28 ", 


"mbCount":13," userAge":" 25"," userld": 2," userName" ;" user2"," userPicture" ;" 20110418221453. 
jpg"},{"fansCount" :4,"idolCount":7,"lastLoginTime":"2011-03-27","mbCount":33,"userAge":"24", 
"userld" :3," userName" : " user3" ," userPicture" :"20110418221357. jpg"}]} 
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表 12-22 获取 收藏 微 博 列表 模块 接口 


接口 说 明 获取 收藏 微 博 列 表 接 口 
接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction!getCollectionInfo. action 

输入 参数 

参数 名 类 型 描述 值 条 件 备注 
pageNow Sting | 当前 列表 页 码 必 填 用 来 做 翻 页 操作 ,记录 当前 页 码 
userld String | 用 户 id 必 填 表示 获取 的 是 该 用 户 的 微 博 收藏 
返回 参数 

参数 名 类 型 描述 

JSON 数据“ |JSON 数据 | 见 返回 参数 说 明 。 如 返回 数据 错误 , 则 根据 错误 代码 构建 JSON 数据 

返回 数据 格式 

字段 名 说 明 备注 
pageCount 记录 分 页 后 的 总 页 数 
results 返回 的 博客 列表 参加 下 面 “results 说 明 ” 部 分 
results 说 明 

字段 名 说 明 备注 
content 博客 内 容 字符 串 类 型 
microBlogId 博客 的 ID 整数 
time 博客 发 表 的 日 期 年 -月 -日 格式 
userId 用 户 ID 发 表 该 博客 的 用 户 ID 
userName 用 户 名 发 表 该 博客 的 用 户 名 称 
用 户头 像 图 片 的 文件 名 s 用 默认 头像 ,该 值 为 "user_headphoto. 
返回 JSON 数据 格式 举例 


("pageCount" ; "178" , "results" :[{"content":"jhgg","microBlogId" :1205, "time":"2012-07-13","userld": 


67 ,"userName" ; "as 


userPhoto";" user headphoto. png") , ( " content" :" jjhgcv "," microBloglId" : 1206, 


"time" ; "2012-07-13" ," userId" :67, "userName" : "as" ,"userPhoto" ;" user. headphoto. png") ]) 


X 1223 删除 收藏 模块 接口 


SD A 删除 收藏 接口 
接口 地 址 http://ip:port/MobileBlog/ClientMicroBlogAction! deleteCollection. action 
输入 参数 
参数 名 类 型 描述 值 条 件 备注 
collection. microBlog.id| String | 被 收藏 的 微 博 ID 必 填 
collection. user. id Sting | 收藏 者 用 户 ID 必 填 
返回 参数 
参数 名 类 型 描述 
result String | 见 返回 参数 说 明 
返回 数据 格式 
字段 名 说 明 字段 类 型 备注 
success 删除 收藏 成 功 String 


2) 客户 端 数据 通信 的 代码 
在 本 实例 中 ,手机 客户 端 与 网 络 服务 器 的 数据 通信 方法 sendPostHttpRequest() 定 义 在 
本 项 目的 com. sample. connection 包 下 HttpCommunication 类 中 ,其 代码 如 下 。 


第 12 章 ”应 用 项 目 开发 实例 w7 


package com. sample. connection; 


X 

2 

3 import java. io. BufferedReader; 

4 import java. io. IOException; 

5 import java. io. InputStream; 

6 import java. io. InputStreamReader; 

7 import java. io. UnsupportedEncodingException; 
8 import java. util. List; 

9 


10 import org.apache. http. HttpEntity; 

11 import org. apache. http. HttpResponse; 

12 import org. apache. http. HttpStatus; 

13 import org. apache. http. NaneValuePair; 

14 import org. apache. http. client.HttpClient; 

15 import org. apache. http. client. entity. UrlEncodedFormEntity; 
16 import org.apache. http. client. methods. HttpPost; 

17 import org. apache. http. impl.client.DefaultHttpClient; 


18 

19 import android. util. Log; 

20 

21 import com. sample. common. Constants; 

22 

23 public class HttpCommunication { 

24 

25 private static HttpClient httpClient = null; 

26 

27 public static HttpClient getHttpClient() ( 

28 if (httpClient == null) { 

29 httpClient = new DefaultHttpClient(); 

30 ] 

31 return httpClient; 

32 ) 

33 

34 public static String sendPostHttpRequest(String url, 

35 List < NameValuePair? params) ( 

36 // 设 置 HttpPost 连接 对 象 (HttpPost 即 为 HttpRequest) 

37 HttpPost httpPost = new HttpPost(Constants. SERVERADDRESS + url); 

38 try { 

39 // 设 置 字 符 集 为 utf -8 

40 HttpEntity httpEntity = new UrlEncodedFormEntity(params, "utf - 8"); 
41 // 使 用 BttpPost 类 的 setEntity( ) 方 法 设置 请 求 参数 

42 httpPost.setEntity(httpEntity); 

43 // 使 用 DefaultHttpClient 为 HttpClient 

44 HttpClient httpClient = getHttpClient(); 

45 // 取 得 HttpResponse 对 象 

46 HttpResponse httpResponse = httpClient. execute(httpPost); 

47 //BttpStatus.SC OK 表示 连接 成 功 

48 if (httpResponse. getStatusLine().getStatusCode() HttpStatus.SC OK) { 
49 // 取 得 返回 的 字符 串 

50 String result = ""; 

51 if (httpResponse.getEntity() != null) { 

52 InputStream is - httpResponse.getEntity().getContent(); 
53 result = convertStreamToString(is); // 将 输入 流转 换 为 字符 串 
54 return result.trim(); 
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56 
57 
58 
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64 
65 
66 
67 
68 
69 
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71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95] 


上 述 类 代码 主要 定义 了 sendPostHttpRequest( ) 方 法 。 该 方法 完成 向 服务 器 端 传送 
UTF-8 参数 ,同时 也 接收 从 服务 器 传 过 来 的 数据 流 , 并 通过 convertStreamToString() 方 法 将 


} else { 
System. out. println("fail the request"); 
} 


} catch (Exception e) { 
//TODO: handle exception 
e. printStackTrace( ); 

) 

return null; 


) 


public static String convertStreamToString(InputStream ism) ( 
BufferedReader reader = null; 
try ( 
reader = new BufferedReader(new InputStreamReader( ism, "UTF - 8"), 
// 防 止 模拟 器 上 的 乱码 
512 * 1024); 
) catch (UnsupportedEncodingException el) ( 


el.printStackTrace(); 


) 
StringBuilder sb = new StringBuilder(); 


String line = null; 
try { 
while ((line = reader. readLine()) != null) { 
sb. append(line + "\n"); 
) 
) catch (IOException e) ( 
Log. e("DataProvier convertStreamToString", e.getLocalizedMessage(), 
e; 
} finally { 
try { 
isn.close(); 
] catch (IOException e) ( 
e. printStackTrace(); 
) 
) 
return sb. toString(); 


数据 流转 换 为 字符 串 形式 。 


在 HomePageActivity , MyFavorateActivity ,SearchActivity , UserBlogActivity , UserBlogActivity 等 
多 个 类 中 ,定义 了 方法 shareJSON() 。 该 方法 主要 用 于 实现 把 包含 JSON 数据 结构 的 字符 串 


解析 出 来 ,保存 成 序列 化 的 对 象 。 其 代码 片段 如 下 。 


2 
2 
3 
4 
5 


private void shareJSON() { 


String url = "/ClientMicroBlogAction! getMicroBlogInfo. action"; 
List < NameValuePair > params = new ArrayList < NameValuePair»(); 


// 表 单 参数 
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6 params.add(new BasicNameValuePair("pageNow", pageNow * "")); 

7 params. add(new BasicNameValuePair("userId", LocalStorage.getString( 

8 HomePageActivity.this, "userId"))); 

9 

10 Log. i(TAG, 

11 "getUserId : " 

12 + LocalStorage. getString(HomePageActivity. this, 

13 "userId")); 

14 // 返 回 JSON 字符 串 , 并 解析 

15 json = HttpCommunication. sendPostHttpRequest(url, params); 

16 

17 try ( 

18 // 获 取 根 节点 

19 JSONObject root = new JSONObject(json. toString()); 

20 pageCount = root.getInt("pageCount"); 

21 Log.i(TAG, "pageCount >>>>> ^ " + pageCount); 

22 JSONArray items - root.getJSONArray("results"); 

23 for (inti = 0; i< items. length(); i++) ( 

24 MicroBlogHP share = new MicroBlogHP(); 

25 Share. setMicroblogId(Integer. parseInt(items.getJSONObject( i) 
26 .getString("microBlogId"))); 

27 share. setUserId(Integer. parseInt(items.getJSONObject(i) 

28 .getString("userId"))); 

29 share. setUserNane( items. getJSONObject(i).getString("userName")); 
30 Share.setUserPicture(Constants. SERVERADDRESS + "/headPhoto/" 
31 * items.getJSONObject(i).getString("userPhoto")); 
32 share. setContent( items. getJSONObject(i).getString("content")); 
33 share. setTime(items.getJSONObject(i).getString("time")); 

34 list.add(share); 

35 } 

36 

37 } catch (JSONException e) { 

38 

39 e. printStackTrace(); 

40 } 

41 

42 } 

ee 


shareJSON() 方 法 向 网 络 服务 器 中 传人 两 个 参数 url 和 params, 其 中 参数 url 的 值 是 提供 处 
理 该 数据 通信 的 接口 地 址 ,例如 “url = "/ClientMicroBlogAction! getMicroBlogInfo. action";” 表 
示 这 个 HTTP 请 求 由 服务 器 的 ClientMicroBlogAction 类 里 面 的 getMicroBlogInfo() 方 法 来 负责 
处 理 。 参 数 params 的 值 是 传人 服务 器 的 键 值 对 ,上 述 代码 中 的 params 包含 博客 列表 的 当前 
页 码 和 用 户 ID 号 。 


3. 部 分 代码 解析 


1) 获取 头像 

本 实例 在 用 户 注册 的 RegisterActivity 活动 中 获取 头像 的 方式 有 两 种 : 一 是 调用 Android 
自 带 的 拍照 应 用 程序 进行 拍照 获取 ,使 用 Android 自 带 的 拍照 应 用 时 使 用 的 Intent 参数 是 
MediaStore. ACTION IMAGE CAPTURE; 二 是 从 SD 卡 的 相册 中 获取 头像 ,SD 卡 的 
DCIM/Camera 目录 是 相册 的 存储 位 置 。 相 关 的 代码 如 下 。 
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B. xm 

2 f** 

3 * 拍照 获取 图 片 

4 * 

5 */ 

6 protected void doTakePhoto() { 

7 try ( 

8 //Launch camera to take photo for selected contact 

9 PHOTO DIR. nkdirs(); // 创 建 照 片 的 存储 目录 

10 mCurrentPhotoFile = new File(PHOTO_DIR，getPhotoFileName());// 给 新 照 的 照片 
// 文 件 命名 

11 final Intent intent = getTakePickIntent(mCurrentPhotoFile); 

12 startActivityForResult(intent, CAMERA WITH DATA); 

13 ) catch (ActivityNotFoundException e) ( 

14 Toast.makeText(this, R.string. photoPickerNotFoundText, 

15 Toast.LENGTH LONG).show(); 

16 ) 

17 ) 

18 

19 public static Intent getTakePickIntent(File f) ( 

20 Intent intent = new Intent(MediaStore. ACTION IMAGE CAPTURE, null); 

21 intent. putExtra(MediaStore. EXTRA OUTPUT, Uri.fronFile(f)); 

22 return intent; 

23 } 

24 

25 /** 

26 — * 用 当前 时 间 给 取得 的 图 片 命名 

27 * 

28 ui 

29 private String getPhotoFileName() ( 

30 Date date = new Date(Systenm. currentTimeMillis()); 

31 SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMddhhnnmss" ) ; 

32 return dateFormat.format(date) * ".png"; 

33 } 

34 


35 // 请 求 Gallery 程序 ,从 相册 中 去 获取 
36 protected void doPickPhotoFromGallery() ( 


37 try { 

38 //Launch picker to choose photo for selected contact 

39 final Intent intent = getPhotoPickIntent(); 

40 startActivityForResult(intent, PHOTO PICKED WITH DATA); 
4l ) catch (ActivityNotFoundException e) ( 

42 Toast.makeText(this, R. string. photoPickerNotFoundTextl, 
43 Toast.LENGTH LONG). show() ; 

44 H 

45 } 

46 


47 // 封 装 请 求 Gallery 的 intent 
48 public static Intent getPhotoPickIntent() { 


49 Intent intent = new Intent( Intent. ACTION GET CONTENT, null); 
50 intent. setType(" inage/ * "); 

51 intent.putExtra("crop", "true"); 

52 intent. putExtra("aspectX", 1); 

53 intent. putExtra("aspectY", 1); 


54 intent. putExtra("outputX", 80); 
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intent. putExtra("outputY", 80); 
intent. putExtra("return- data", true); 
return intent; 


// 因 为 调用 了 Camera 和 Gallery 所 以 要 判断 它们 各 自 的 返回 情况 ,它们 启动 时 是 使 用 
//startActivityForResult() 方 法 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (resultCode != RESULT OK) 
return; 
switch (requestCode) ( 
case PHOTO PICKED WITH DATA: {// 调 用 Gallery 返回 的 
final Bitmap photo = data.getParcelableExtra("data"); 
// 下 面 就 是 显示 照片 了 
System. out. println(photo); 
// 缓 存 用 户 选 择 的 图 片 
img = getBitmapByte(photo); 
Log. v("RegisterActivity", "new photo set!"); 
/ [nEditor. setPhotoBitmap(photo) ; 
iv headPhoto. setImageBitmap(photo); 
Systen. out. println("set new photo") ; 
photoName - getPhotoFileName(); 
break; 
) 
case CAMERA_WITH_DATA: {// 照 相机 程序 返回 的 ,再 次 调用 图 片 剪 辑 程 序 去 修剪 图 片 
doCropPhoto( mCurrentPhotoFile); 
break; 


} 


// 将 字 节 数组 转换 为 bitmap 
public Bitmap getBitmapFromByte(byte[] temp) { 
if (temp != null) ( 
Bitmap bitmap = BitmapFactory.decodeByteArray(temp, 0, temp. length); 
return bitmap; 
) eise( 
return null; 


} 


// 将 头像 转换 成 byte[ ] 以 便 能 将 图 片上 传 到 服务 器 

public byte[ ] getBitmapByte(Bitmap bitmap) { 
ByteArrayOutputStream out = new ByteArrayOutputStrean(); 
bitmap.compress(Bitmap. CompressFormat.PNG, 100, out); 
return out. toByteArray(); 


protected void doCropPhoto(File f) ( 
try f 
final Intent intent = getCropImageIntent(Uri.fromFile(f)); 
starthctivityForResult(intent, PHOTO PICKED WITH DATA); 
} catch (Exception e) { 
Toast.makeText(this, R.string. photoPickerNotFoundText, 
Toast. LENGTH LONG). show() ; 
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109 } 

110 } 

111 

112 /* 

113 * Constructs an intent for image cropping. 调用 图 片 剪辑 程序 
114 x/ 


215 public static Intent getCropImageIntent(Uri photoUri) { 


116 Intent 
117 intent. 
118 intent 
119 intent 
120 intent 
121 intent 


122 intent 
123 intent 
124 return 
125 ) 

126: 


代码 中 ,doTakePhoto O , get TakePickIntent () 方 法 是 定义 启用 Android 自 带 的 拍照 应 用 ; 
getPhotoFileName() 方 法 为 图 像 文 件 命名 ; doPickPhotoFromGallery() , getPhotoPickIntent O 77 3: 
是 定义 从 SD 卡 的 相册 中 取 头 像 操 作 ; onActivityResult() 方 法 是 处 理 调用 拍照 (Camera) 和 相册 
(Gallery) 的 返回 情况 ; getBitmapFromByteO ,getBitmapByteO .doCropPhoto() .getCropImageIntent() 


intent = new Intent("com.android. camera.action.CROP"); 


. setDataAndType( photoUri, "image/ * "); 
. putExtra("crop", "true"); 
.putExtra("aspectX", 1); 

. putExtra("aspectY", 1); 
.putExtra("outputX", 80); 
.putExtra("outputY", 80); 
.putExtra("return- data", true); 


intent; 


这 些 方法 是 对 图 像 进行 存储 格式 转换 或 剪辑 等 加 工 处 理 的 方法 。 


2) 计算 显示 页 


在 HomePageActivity 中 显示 博客 列表 时 , 当 博 客 数量 较 多 时 ,一 屏 显 示 不 下 ,系统 自动 


对 博客 列表 进行 分 页 。 如 果 向 下 滑动 ,可 以 看 到 第 2 页 .第 3 页 等 列表 项 。 相 关 代码 如 下 。 
和 
2 listView. setOnScrollListener(new OnScrollListener() { 
3 
4 @Override 
5 public void onScrollStateChanged(AbsListView view, int scrollState) { 
6 // TODO Auto - generated method stub 
? Log. i(TAG, "onScrollStateChanged "); 
8 ) 
9 
10 (QOverride 
11 public void onScroll(AbsListView view, int firstVisibleItem, 
12 int visibleltemCount, int totalltemCount) { 
13 //'T0DO Auto - generated method stub 
14 Log.i(TAG, "Scroll»»» first: " + firstVisibleltem 
15 + ", visible: " + visibleltemCount + ", total: " 
16 * totalltemCount); 
17 // 是 否 还 有 可 加 载 页 
18 if (pageNow < pageCount) ( 
19 // 判 断 是 否 滑动 到 底部 
20 if (firstVisibleItem + visibleItemCount == totalltemCount) { 
21 pageNow += 1; 
22 // 加 载 数据 
23 shareJSON() ; 
24 / [383 listview 
25 adapter. notifyDataSetChanged(); 


H); 
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// 显 示 最 新 加 载 的 最 上 面 一 条 
listView.setSelection(firstVisibleItem 
+ visibleItemCount - 2); 


Toast. makeText(HomePageActivity.this, 
"第 "+ pageNow + "Ji", Toast.LENGTH LONG). show(); 
} 
} else { 
// 最 后 一 页 去 除 加 载 进度 条 
listView. removeFooterView(loadingLayout); 


在 list View. setOnScrollListener() 监 听 接 口中 来 定义 相关 代码 。listView 列表 项 是 按 页 
显示 博客 项 的 ,具体 处 理 分 页 的 代码 在 服务 器 控制 程序 中 定义 ,在 手机 客户 端 只 是 通过 接口 进 
行 加 载 数据 即 可 。 

3) 计算 编辑 区 剩余 字数 

在 NewBlogActivity 中 进行 编辑 博客 时 ,可 以 对 编辑 过 程 实施 监听 ,计算 出 剩余 的 输入 字 
符 个 数 。 相 关 代 码 如 下 。 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


//TODO Auto - generated method stub 
super. onCreate(savedInstanceState); 
setContentView(R. layout. writemb); 


et mb content = (EditText) findViewById(R. id. tab wmb Content); 


et mb content. addTextChangedListener(new TextWatcher() { 


private CharSequence temp; 


@Override 
public void onTextChanged(CharSequence s, int start, int before, 
int count) { 
//TODO Auto - generated method stub 


) 


@Override 
public void beforeTextChanged(CharSequence s, int start, int count, 
int after) { 
//TODO Auto - generated method stub 
temp = s; 


} 


@Override 

public void afterTextChanged(Editable s) { 
//TODO Auto - generated method stub 
int size = 150 - temp.length(); 
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31 tv mb contentSize.setText(size + ""); 


代码 中 ,对 Edit Text 对 象 添加 监听 器 ,其 监听 接口 为 addTextChangedListenerO ,. fE K 
中 ,onTextChanged() ,beforeTextChanged OO ,afterTextChanged () 分 别 是 修改 中 、 修 改 前 、 修 
改 后 的 回调 事件 方法 


12.4 手机 客户 端的 测试 运行 


在 开发 完成 应 用 程序 后 都 需要 对 其 进行 测试 运行 ,通常 是 先 在 模拟 器 中 进行 测试 , 待 测试 
通过 之 后 再 签 ep 发 布 到 手机 真 机 中 和 运行。 在 模拟 器 中 和 运行 手机 微 博 程序 时 ,需要 保证 
Tomcat 服务 器 是 开启 状态 ,并 且 检 查 代码 中 的 IP 地 址 与 本 机 IP 一 致 等 准备 工作 。 

1. 运行 前 的 准备 工作 


CD 查看 本 机 IP 地 址 。 
在 命令 行 状 态 下 输入 ipconfig 命令 , 即 可 看 到 本 机 的 TP 地 址 等 信息 ,如 图 12-27 所 示 。 


77:d12c:fe79x12 


图 12-27 查看 本 机 的 IP 信息 


类 后 检查 本 应 用 项 目 中 两 TA 文件 中 的 IP 地 址 是 否 与 本 机 IP 一 致 : 打开 Constants. 
java 文件 ,检查 SERVERADDRESS 常量 所 指 的 IP 地 址 是 否 与 本 机 IP 一 致 ,打开 Strings. 
xml 文件 ,检查 二 string name=" serverAddress" >R Æ P ÁY IP 地 址 描述 是 否 与 本 机 IP 一 致 。 
如 果 不 一 致 ,需要 修改 代码 中 的 IP 为 本 机 IP。 

(2) 在 Eclipse 中 启动 Tomcat 服务 器 ,如 图 12-28 所 示 。 


Snippets E) Console i Servers pora 


图 12-28 启动 Tomcat 服务 器 
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(3) 在 Eclipse 中 启动 模拟 器 。 本 实例 使 用 的 SDK 最 低 版 本 为 2. 1 ,所 以 可 以 启动 2. 1 以 
上 版 本 (包含 2. 1 版 本 ) 的 模拟 器 。 

2. 运行 手机 微 博 应 用 

在 Eclipse 中 选择 项 目 MobileBlog_Android, 然 后 右 击 , 在 弹出 菜单 中 选择 Run As 一 
Android Application, 开 始 运行 项 目 。 

1) 系统 登录 

运行 MobileBlog Android 项 目 , 出 现 登录 界面 。 首 次 运行 时 ,“ 用 户 名 ”和 “密码 "输入 框 
为 空 , 如 图 12-29 所 示 ; 再 次 运行 此 项 目 , 系 统 记 住 了 上 一 次 登录 时 使 用 的 用 户 名 和 密码 ,如 
图 12-30 所 示 。 


图 12-29 首次 登录 系统 图 12-30 再 次 登录 系统 


2) 注册 新 用 户 


如 果 需 要 注册 新 用 户 , 则 单 击 登录 窗口 中 的 “注册 ”按钮 ,进入 注册 窗口 ,如 图 12-31 所 示 。 
息 , 并 且 可 以 通过 拍照 或 从 SD 卡 中 载 人 头像 来 更 换 原 默认 头像 。 注 册 信息 


依次 录入 注册 信 } 
录入 完成 后 单 击 


注册 ”按钮 ,如 图 12-32 所 示 。 


\ 


注册 
用 户 注册 成 功 


点 击 确定 后 返回 登录 


确定 


à j 
Ih 
Br 
[4 
E] 


u 
日 


图 12-31 进入 注册 窗口 图 12-32 注册 完成 
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3) 进入 首页 

如 果 是 新 注册 的 用 户 , 进 入 首页 将 看 不 到 任何 信息 ,这 是 因为 新 注册 的 用 户 既 没有 写 一 篇 
博客 ,也 没有 关注 其 他 的 用 户 的 博客 。 

如 果 是 老 用 户 ,首页 将 以 列表 的 方式 显示 本 用 户 所 写 的 博客 或 转发 的 博客 ,以 及 所 关注 的 
用 户 发 送 的 博客 ,如 图 12-33 所 示 。 如 果 要 查看 博客 的 详情 ,在 某 条 博客 上 长 按 , 进 入 该 条 博 
客 的 详细 界面 ,如 图 12-34 所 示 。 


User1 
r 


frank 


frank 


图 12-33 ”当前 用 户 及 关注 用 户 的 博客 列表 图 12-34 第 一 条 userl 用 户 的 博客 


4) 发 表 博 客 

在 此 界面 中 可 以 写 150 个 字符 的 微 博 内 容 。 在 写 博 客 的 过 程 中 ,编辑 框 下 方 可 以 自动 实 
时 地 计算 还 能 录入 的 字符 数 , 如 图 12-35 所 示 

5) 个 人 信息 

在 个 人 信息 中 可 以 查看 当前 用 户 的 注册 信息 ,如 图 12-36 所 示 。 在 图 12-36 中 单 击 “ 关 
注 (4)”, 可 以 查看 详细 的 关注 用 户 列 表 , 如 图 12-37 所 示 。 


User1 
微 博 (10) 关注 (12 
User2 

This is my first blog 微 博 (13) 


user4 


微 博 (4) 


图 12-35” 写 微 博 界面 图 12-36 个 人 信息 页 图 12-37 查看 关注 的 用 户 
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6) 收藏 管理 


进入 收藏 页 ,可 以 查看 当前 用 户 所 收藏 的 用 户 列表 ,如 图 12-38 所 示 。 


可 执行 删除 此 条 收藏 信息 ,如 图 12-39 所 示 。 


User1 
Tm user 


al user2 


应 


À 


用 项 目 开发 实例 


Rio AR HP LU 


图 12-38 收藏 用 户 列表 图 12-39 删除 一 条 收藏 信息 


7) 查找 用 户 


在 “查找 用 户 ” 编 辑 框 内 输入 要 查找 的 用 户 名 ,然后 单 击 “ 查 找 ” 图 标 ,可 以 查找 到 服务 器 中 
所 有 以 输入 字符 开头 的 用 户 名 ,如 图 12-40 所 示 。 如 果 在 某 条 用 户 上 长 按 ,可 出 现 关 注 该 用 户 


的 对 话 框 ,如 图 12-41 所 示 。 


User1 28 
微 博 (9) 关注 (12) 粉丝 (7) 


user2 25 


微 博 (13) 关注 (6 


user3 24 
微 博 (33) 关注 (7) 粉丝 (4) 
user4 26 

- 微 博 (4) 关注 (6) 粉丝 (3) 


图 12-40 ”查找 以 “user” 开 头 的 用 户 图 12-41 关注 选中 用 户 


12.5 项 目 打包 、 签 名 和 发 布 


在 手机 微 博客 户 端 程序 测试 运行 通过 后 , 接 下 来 就 要 签名 、 打 包 , 然 后 发 布 使 用 。 在 10.5 
节 中 已 经 详细 地 介绍 了 应 用 程序 的 签名 打包 操作 ,这 里 不 多 作 蓝 述 ,只 针对 本 实例 的 签名 和 打 
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包 进 行 简单 描述 。 

在 Eclipse 中 选择 本 实例 项 目 MobileBlog_Android, 右 击 , 在 弹出 菜单 中 选择 Android 
Tools 一 Export Signed Application Packge. .. ,出 现 如 图 12-42 所 示 的 对 话 框 。 

单 击 Next 按钮 ,进入 签名 文件 的 定义 页 ,完成 签名 文件 名 、 路 径 及 签名 文件 密码 的 定义 ， 
如 图 12-43 所 示 。 


Project Checks Keystore selection 


Performs a set of checks to make sure the application can be exported. 


Select the project to export: 
Project: MobileBlog Android 


© Use existing keystore 
@ Create new keystore 
|| Location: EMAndroidCode hz wnbandroid keystore 


Password: eeeesesee. 


|| Conf: ee 


图 12-42 选择 签名 打包 的 项 目 图 12-43 ”签名 文件 定义 页 


然后 单 击 Next 按钮 ,进入 生成 签名 文件 信息 页 ,录入 相关 信息 ,其 中 密码 和 签名 文件 定 
义 页 的 一 致 ,如 图 12-44 Bron o 

单 击 Next 按钮 ,进入 生成 打包 文件 页 ,确定 打包 文件 的 存放 路 径 和 打包 文件 名 ,如 图 12-45 
所 示 。 


Destination and key/certificate checks 


MB Android. 


Destination APK file: EMAndroidCodeXCh12WB Android.apk 


expires in 200 years 


it sgmsccomcn 
3gmsc 
Guangzhou 
Guangdong 
| Country Code 000: [en 


CE re ro (etm 


图 12-44 生成 签名 文件 信息 页 12-45 生成 打包 文件 页 
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然后 单 击 Finish 按钮 ,完成 本 实例 的 签名 和 打包 ,可 以 在 指定 的 文件 夹 下 (本 书 指定 的 文 
HRH E: radi tage 文件 和 打包 文件 ,如 图 12-46 所 示 。 这 样 得 到 
的 打包 文件 是 经 过 了 一 个 证 书 文件 的 加 密 处 理 的 。 现 在 可 以 将 生成 的 打包 文件 上 传 到 网 络 
Ts i andes. 


mmm 


2012-7-16 18:06 — Xr 
20012251144 AKRE č 
2012-7-25 11:36 KEYSTORE 文件 
2012-7-21 23:04 WAR 文件 


MB Android.apk BEI 2012-7-25 11:44 SEENE 2012-7-25 1136 
APK 文 件 大 小 190 KB 


图 12-46 ”指定 文件 夹 下 的 内 容 


本 童 以 开发 手机 微 博 客户 端 应 用 程序 为 例 ,向 读者 展示 了 一 个 实际 应 用 开发 的 全 过 程 。 
大 多 数 Android 应 用 项 目 是 运行 在 无 线 互联 网 上 的 应 用 ,需要 与 网 络 服务 器 进行 通信 ,需要 与 
服务 器 数据 库 进 行 数据 存 取 。 因 此 ,本 章 所 述 主要 涉及 整个 项 目的 功能 、 环 境 设置 数据 库 及 
数据 库 服 务 器 、Android 的 手机 客户 端 程序 的 主要 实现 及 其 测试 发布 等 重点 内 容 。 

对 于 一 个 实际 的 项 目 ,Android 手机 端的 程序 设计 只 是 项 目 中 一 部 分 ,还 需要 对 服务 器 端 
的 应 用 进行 编程 。 本 章 省 略 了 服务 器 端 应 用 程序 的 介绍 ,只 是 给 出 了 一 个 应 用 程序 压缩 文件 
包 MobileBlog. war。 如 果 读 者 有 志 在 手机 应 用 开发 中 继续 发 展 , 最 好 学 习 一 下 Java 的 Web 
编程 课程 。 


练习 


1. 在 自己 的 计算 机 中 安装 配置 本 章 介绍 的 应 用 项 目 ( 包 括 Tomcat 服务 器 ,MySQL 数据 
库 环境 ,数据 库 表 , Web 端 应 用 程序 包 , Android 手机 客户 端 应 用 程序 等 ) ,并 运行 。 理 解 本 书 
给 出 的 “手机 微 博客 户 端的 应 用 项 目 范例 。 

2. 尝试 改进 与 完善 本 案例 的 功能 。 
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